Mirafold — generative UI for your terminal coding agent
). -->
Claude Code · Codex · Gemini CLI
Generative UI for the coding agent<br>you already trust.
Your coding agent works in the terminal, but its answers do not have<br>to look like terminal output.
src with Kyle's properly<br>recorded demo when it exists. Keep the frame and the element.<br>THREE things describe this file and all three must move together on a<br>demo.vN bump: the src/poster below, the VideoObject JSON-LD in ,<br>and the aria-label + fallback text below (what a screen-reader user<br>and anyone whose video fails to load actually gets). The aria-label<br>was the one left behind at the v8 recut and spent two versions<br>describing beats that were no longer on camera — 2026-07-29. -->
localhost:3000<br>demo
Mirafold demo: asking about a repo returns an overview card, a<br>dependency table, and doc links; a test-and-fix request pauses on a<br>permission strip the user clicks to allow — a live working indicator<br>ticking whenever the agent is busy — then streams the failing run as<br>colored console output, checks off a live task list, lands the fix as<br>a red-green diff, and re-runs green; the user opens the file explorer,<br>reads the change's git diff, and enlarges it near-full-screen over the<br>dimmed workspace before clicking the agent's commit question; a shell<br>command typed with a leading exclamation mark runs in a real terminal,<br>so sudo's password prompt appears and is answered in a masked input the<br>agent never sees, after which the agent reads the command's output and<br>answers unprompted; a bundle question becomes a pie chart and a stat<br>tile, pinned and then updated in place; a final prompt renders an<br>architecture diagram in a sandboxed frame.
Mirafold turns dense scrollback into a clear, readable interface in<br>the browser, as your agent runs.
Keep Claude Code, Codex, or Gemini CLI
Keep your own keys
Keep everything on your machine
And when the work calls for it, Mirafold can generate live cards,<br>tables, charts, and other interactive views.
Pin the ones worth keeping; they stay live as the work moves on.
install
❯npm i -g mirafold
❯cd ~/your/project
❯mirafold
copy
Free and open source — MIT. Requires Node 22+.
# what it is
01<br>faithful, per agent
A Codex user gets Codex in the browser — never “Claude things.”<br>Each agent drives its own engine and inherits your own<br>settings, memory, and permission rules, exactly as in the terminal.<br>Switching in and out costs nothing.
02<br>the agent paints UI
Output is treated as a UI-instruction stream: markdown streams in,<br>and when a component says it better than prose, the agent mounts one —<br>cards, tables, charts, task lists. When nothing fits, it ships<br>arbitrary UI into a locked-down sandbox.
03<br>your sessions, on any screen
Run as many sessions as you want — each with its own directory and<br>agent — and open as many live viewports onto any one of them as you<br>like: a second tab, a third, a paired phone (Pro, over an<br>end-to-end-encrypted relay). Every viewport stays in step mid-turn, and<br>any of them can steer.
04<br>never less than the terminal
A strict superset: thinking, full tool detail and diffs, subagent<br>progress, the live task list, token and cost usage — all streamed<br>live, then folded to dim one-liners so the transcript stays clean.
05<br>a shell the agent can’t touch
The agent paints the output zone and nothing else. The prompt box,<br>the socket, and your credentials live in a trusted shell it can’t<br>render into — and agent-authored HTML executes only inside a<br>no-network, opaque-origin iframe.
06<br>your machine, your key
The daemon runs locally, like the terminal agent does. API keys<br>never reach the browser. Or skip keys entirely and point your agent at<br>a local model — Ollama, LM Studio, vLLM.
mission control across all your sessions<br>a real-PTY ! passthrough — sudo and ssh prompts actually work<br>pin any rendered block — the agent updates it in place across turns
# pricing
free
$0 open source, MIT
The full local product — nothing held back
Claude Code, Codex, and Gemini CLI
Generative UI, pinned live widgets, sandboxed artifacts
Mission control across unlimited sessions
Your API key or a local model
get the source
7-day free trial<br>pro
$12/mo · $99/yr
The same generative-UI sessions, from any device.
Pair a phone, tablet, or any browser with a QR code
Sessions travel with you — pinned widgets and all
End-to-end encrypted relay: it sees ciphertext and bare<br>connection metadata — never your key, your code, or your<br>content
Your API key or a local model, same as free
start free trial
# faq
Does it work with local models?<br>Yes. A session is fully local when the agent behind it points at a<br>local inference server — Claude Code against Ollama’s Anthropic-style<br>endpoint, or Codex against Ollama, LM Studio, or vLLM. Then nothing —<br>code, key, or tokens — leaves your machine. The repo documents the<br>exact recipe and an honest model/hardware table.
Where does my API key live?<br>In your local daemon’s environment, exactly as...