Claude Code  ·  Codex  ·  Gemini CLI  ·  OpenCode

Reinventing your terminal agent.

It’s no longer just text — it’s a full interface.
Mirafold gives your work the experience it calls for.

install npm i -g mirafold

Same agent, same machine: it keeps its existing settings, memory, permission rules, and credentials.

Free and open source · MIT · Node 22+

what changes

# the interface matches the work

Your agent edits files, runs tests, tracks tasks, produces diffs, asks questions, and reports progress. In a terminal, all of it arrives as one stream of text. Mirafold gives each kind of work the interface it calls for — and leaves text where text is right.

the right form

Structured work gets structured UI.

A change is a diff you can inspect as a change. Progress is a live checklist, not prose buried in history. A comparison is a table, a measurement is a chart, an architecture is a diagram — each appears when it is the better interface for the information, generated by the agent as it works.

  • table
  • chart
  • checklist
  • diff
  • diagram
real controls

You work in it, not just read it.

Continue from a card. Review the real difference between Git HEAD and the working tree in its own Workspace changes view, not in conversation text. Select a hunk, then put its exact code context into the prompt with Explain or Request change — still editable, not sent for you. Permission requests arrive as controls, in a strip the agent cannot touch.

  • follow up
  • select hunk
  • explain
  • request change
  • approve
01

Every session, at a glance.

Mission control puts all your running agents in one grid: their state visible, actions one click away, no hunting through terminal tabs.

02

Nothing the terminal shows is lost.

Thinking, tool calls, diffs, subagents, task status, tokens, and cost all stay available — the full interface is a superset. Prefix a command with ! for a real PTY where interactive sudo and ssh work.

03

The same interface, from any device.

Pro brings the same session to a phone, tablet, or another browser. The end-to-end-encrypted relay sees ciphertext and connection metadata, never your key, code, or content.

04

Keep what matters in view.

Pin a rendered block and it stays visible, updating as the work changes. When the built-in forms are not enough, the agent can ship arbitrary UI into a no-network, opaque-origin sandbox.

# pricing

free

$0 open source, MIT

  • The full local product — nothing held back
  • Claude Code, Codex, Gemini CLI, and OpenCode
  • The full interface: generative UI, Workspace changes, pinned live widgets, sandboxed artifacts
  • Mission control across unlimited sessions
  • Your API key or a local model
get the source
7-day free trial

pro

$12/mo · $99/yr

The Mirafold experience, 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 connection metadata — never your key, your code, or your content
  • Your API key or a local model, same as free
start free trial

# faq

Is this a web UI for Claude Code, Codex, Gemini CLI, and OpenCode?

Yes — a browser interface for the terminal coding agent you already use, rendered faithfully: same engine, same settings, memory, and permission rules as your terminal. Install with npm i -g mirafold, run mirafold in a project directory, and your agent opens in the browser with a full interface for its work — diffs you can inspect, live task lists, tables, charts, and pinned dashboards — instead of one scrolling stream of text.

Does it work with local models?

Yes. A session is fully local when the agent behind it points at a local inference server — Claude Code against Ollama’s Anthropic-style endpoint; Codex against Ollama, LM Studio, or vLLM; or OpenCode through a local provider in its own config. Then nothing — code, key, or tokens — leaves your machine. The repo documents the exact recipes and an honest model/hardware table.

Where does my API key live?

In your local daemon’s environment, exactly as in a terminal — ANTHROPIC_API_KEY and friends. It is never serialized to the browser, and on Pro the relay carries end-to-end-encrypted frames plus the connection metadata any forwarder handles (IPs, timing, byte counts) — never the key or the conversation.

Which API keys and subscription logins work?

Claude and Gemini subscriptions are refused because their terms prohibit third-party use; API keys are the path for those agents. A Codex/ChatGPT sign-in works locally with the caveat shown at sign-in: OpenAI hasn’t clearly permitted third-party use in writing, but visibly tolerates it — your account, your call. OpenCode can use provider API keys or local providers. Its built-in Zen gateway is available in local-only sessions; free-period prompts may be used to train models. Its ChatGPT route carries the same caveat, and other subscription logins are not usable. No subscription login or Zen session runs over the relay.

The agent generates UI — how is that safe?

Two zones, hard boundary. The agent’s output renders only into an output zone: streamed markdown (no raw HTML), schema-validated registry components, and — for arbitrary UI — a sandboxed iframe with an opaque origin and a CSP that cuts every network path. The prompt box, socket, and credentials live in a trusted shell the agent cannot render into, and anything a component does back is validated server-side against an allowlist.

Which agents — and can you add mine?

Claude Code, Codex, Gemini CLI, and OpenCode ship today, each behind its own adapter — none privileged. A new agent is one adapter behind a small interface, not a rewrite; the adapter spec in the repo documents exactly what an engine needs to qualify.

Can I run several sessions and see them all at once?

Yes — run as many sessions as you want, each with its own directory and agent. Mission control shows every session in one grid, at a glance, and you can act on any of them straight from the grid — no hunting through terminal tabs or tmux panes.

Do sudo and ssh work, or do I switch back to a terminal?

They work, in the same page. Type ! before any command and it runs in a real PTY on your machine, so interactive prompts behave: sudo’s password prompt appears in the shell’s own masked input — the agent never sees what you type — and afterward the agent reads the command’s output and picks up from there.

Can I use it from my phone?

Yes — that’s Pro: pair a phone, tablet, or any browser with a QR code, and the same session travels with you — full interface, pinned widgets and all. The relay in between is end-to-end encrypted — it sees ciphertext and bare connection metadata, never your key, your code, or your content. The relay’s code is open source (MIT) like everything else; the hosted relay is the convenience Pro pays for.

What’s open source, and what am I paying for?

The whole product is MIT — shell, daemon, all four adapters, and the relay code itself, so you can read exactly what the piece you’d be trusting can and cannot see. Pro is convenience infrastructure: the hosted relay that lets your devices reach your sessions from anywhere, end-to-end encrypted. If you’d rather self-host the relay, you run the same code we do.

Image

Your agent, your key, your machine — and a full interface for the work.

npm i -g mirafold