OpenCode on desktop, the supported way.

The desktop app drives a user-installed OpenCode binary — never a bundled copy. Pick cli mode (opencode run per fix) or server mode (long-lived opencode serve), then Export, Fix, or Heal from the desktop panel.

cli: opencode run per fix
server: opencode serve :4096
Export: BUGFIX-<game>-<stamp>
Heal: test → fix → re-test

Requirements

What you need installed

The desktop app probes PATH for the binary and degrades gracefully when it is missing — status line, Enable toggle, and Export/Fix/Heal all fall back to an install hint instead of crashing.

Install the OpenCode CLI
Install the opencode binary for your OS (Windows: package manager or npm) and confirm opencode --version prints from a fresh shell.
Put it on PATH
The desktop probes PATH — if the binary is not found you get an install hint, not an error dialog. Re-open the app after changing PATH.
Open the desktop panel
Tick Enable in the desktop OpenCode panel and pick cli or server below. The status dot goes green when the bridge can reach the binary.
Keep secrets out
Paste API keys once per shell session — never into chat, bug exports, or Heal logs. The bridge never logs secrets.

Two modes

opencode run vs opencode serve

Both modes use your installed binary. CLI mode cold-boots per fix; server mode keeps one persistent process so fixes skip the cold boot.

cli (default)

opencode run per fix

Headless opencode run -f BUGFIX-<game>-<stamp>.md per fix. Simplest setup, nothing to keep alive — best when you heal rarely.

server

opencode serve --port 4096

Long-lived sidecar (OPENCODE_MODE=server, OPENCODE_SERVER_URL=http://127.0.0.1:4096). Fixes skip the per-run boot — best for tight Heal loops.

Next steps

Where to go from here

🖥️ Web terminal + desktop panel

What /terminal runs locally vs what the desktop panel drives.

Read the slice →

🔁 Bugtest → fix → retest

Heal loops, token budgets, coin quotes, and MCP pay (queued future).

Read the slice →

OpenCode on desktop, the supported way.

cli

opencode run per fix

server

opencode serve :4096

Export

BUGFIX-<game>-<stamp>

Heal

test → fix → re-test

OpenCode on desktop, the supported way.

What you need installed

Install the OpenCode CLI

Put it on PATH

Open the desktop panel

Keep secrets out

opencode run vs opencode serve

Where to go from here

OpenCode on desktop, the supported way.

What you need installed

Install the OpenCode CLI

Put it on PATH

Open the desktop panel

Keep secrets out

opencode run vs opencode serve

Where to go from here