Skip to content

Start with opencode

opencode is the quickest way to start: it has free models and needs no account. wisp can install it for you.

Install it

With no agent installed, home offers Install opencode. Otherwise open Settings (the person button in the top bar, or ⌘K → Settings) → Agents and press Install next to opencode. It goes into ~/.wisp/tools, usually in under a minute.

In the browser (wisp --browser, or your cloud wisp) it’s the same window, menus and keys.

Settings → Agents: each harness with its accounts and sign-in state, and an Add key buttonSettings → Agents: each harness with its accounts and sign-in state, and an Add key button

Sign in (optional)

Free models need nothing. For other providers, sign in with opencode’s own login in a terminal, then press Re-check in Settings → Agents (wisp accounts recheck). The row says Free models only until a provider is signed in.

Pick it and its model

wisp reads opencode’s models and their variants. The effort you pick becomes the model’s variant.

Click the harness chip in the New task footer (N), pick opencode, then a model. Type to search a long list. On a running task, the same chip in the reply box changes it for the next follow-up.

Modes: Plan, Edits, Full auto (--mode plan|edits|auto). In Edits, a command opencode wasn’t allowed to run shows as blocked on the task.

What wisp adds for opencode

  • wisp’s MCP server and your grants go in with each run, merged over your own OPENCODE_CONFIG_CONTENT.
  • When a provider rate-limits it, opencode retries in silence. wisp notices and stops the run, so it doesn’t hang.
  • Update to … in Settings → Agents runs opencode’s own upgrade.

Open in opencode

Open the task’s ⋯ at its top right → Open in › Open in opencode (key T). opencode opens in a terminal in the side panel.