Mirafold makes terminal agents actually look modern

Markdown in a terminal is fine until you're staring at a massive diff or a complex data table that wraps every three words. I've been using Claude Code and various CLI agents for a while, but the "1990s text terminal" vibe is a bit limiting. Mirafold basically fixes this by acting as a generative UI skin for the agents you already use. It doesn't change the logic or the LLM—it just renders the output as actual UI components.

If the agent wants to show a chart, a checklist, or a graph, you get a real component instead of a bunch of ASCII art. There are about 18 different components it can trigger, which makes the whole AI workflow feel less like a chat bot and more like a dedicated IDE.

Setting it up

Getting it running is pretty straightforward since it's a global npm package. You can hook it up to Codex, Claude Code, or Gemini.

1. Install the package globally:

npm i -g mirafold

2. Configure your API keys for whichever model you prefer. It works with the big players or local models if you're running something via Ollama and don't want to deal with keys.
3. Launch the session and you'll see the folder tree and files on the side, with the generative UI in the center.

The bits that actually matter for devs

The "Fleet View" is probably the most practical part for anyone managing multiple tasks. It's basically a mission control dashboard where you can monitor several agent sessions at once. You can see if an agent is stuck on a permission request or if a long-running task finished without having to click into every single tab.

Another huge win is the integrated PTY. Usually, when you're in an agent session, you have to jump out to a separate terminal window to run a quick sudo command or ssh into a server. With Mirafold, you just prefix the command with an exclamation mark:

!sudo systemctl restart nginx

This keeps the context in one place and stops the constant window-switching fatigue.

For those who want to move their workflow to mobile, there's a QR code system that uses an encrypted relay to mirror the session to your phone. You can either self-host the relay (since it's open source) or pay for the hosted version.

The project is still in public beta, so there are probably some rough edges, but it's a massive upgrade over raw terminal output. If you're tired of scrolling through endless walls of text in your CLI, this is a solid way to bring some actual visual structure to your LLM agent.

https://github.com/mirafold/mirafold