Two terminals, two jobs.

The web /terminal runs allow-listed local commands only — no server exec, no eval. Driving OpenCode is the desktop panel's job: it shells to your installed opencode binary with a working-dir guard, timeout, and stop button.

/terminal: local allow-list only
desktop: opencode binary
guard: workspace root
stop: per-run timeout

Web side

Attach to /terminal for local commands

The web terminal maps every input to a TypeScript handler — there is no remote shell behind it. Use it for local power-user commands (help, coin quotes, deterministic seeds); it stays fail-open offline.

Open /terminal
Visit /terminal in the web app — Quake-style CLI, history capped, every command emits an interop event.
Stay inside the allow-list
Unknown input prints help instead of executing. There is no server exec, no fetch, no eval — by design, not by accident.
Need OpenCode? Switch surfaces
The web terminal cannot reach your machine's opencode binary. For Export / Fix / Heal, move to the desktop panel below.

Desktop side

The desktop panel drives opencode

The desktop terminal panel (sibling desktop lane) offers a command input, scrolling output, working-dir picker, and stop button. It spawns headless opencode runs — it never reimplements the CLI bridge.

Working-dir guard

Runs are rooted at your workspace — never the repo root, never your home directory.

Timeout + stop

Every run carries a per-run timeout and a stop button; stdout/stderr stream back live.

Fail-open when absent

No binary on PATH? The panel shows the install hint and Export still writes the BUGFIX report.

Up next

Heal with a budget, not a hope

Once the panel is green, the Heal button loops bugtest → fix → retest until clean or the budget is spent. The next page covers that loop.

← Setup

CLI requirements and run vs serve modes.

🔁 Heal loops →

Token budgets, coin quotes, MCP pay (queued future).

Two terminals, two jobs.

/terminal

local allow-list only

desktop

opencode binary

guard

workspace root

stop

per-run timeout

Two terminals, two jobs.

Attach to /terminal for local commands

Open /terminal

Stay inside the allow-list

Need OpenCode? Switch surfaces

The desktop panel drives opencode

Heal with a budget, not a hope

Two terminals, two jobs.

Attach to /terminal for local commands

Open /terminal

Stay inside the allow-list

Need OpenCode? Switch surfaces

The desktop panel drives opencode

Heal with a budget, not a hope