opencode CLI. It starts opencode acp, OpenCode’s own agent protocol server, so there is no adapter to install.
What you need
Theopencode CLI, from opencode.ai. Arakun looks for it on your PATH, then in ~/.local/bin, /usr/local/bin and /usr/bin. Set ARAKUN_OPENCODE_BIN to use another binary, or ARAKUN_OPENCODE_ACP to run another command instead of opencode acp.
Sign in
OpenCode signs in to providers, and Arakun uses the keys it saves. Open Settings › OpenCode:- OpenCode Go: click Get API key to open the OpenCode console and copy your key. Then click Connect. A terminal runs
opencode auth login -p opencode-goand asks only for the key. - Another provider: click Sign in, or Add provider once one is signed in. A terminal runs
opencode auth login; pick a provider and paste its API key.
opencode auth login in any terminal. You don’t need a project open. Sign out runs opencode auth logout.
Arakun has no account of its own. It reads only which providers are in OpenCode’s auth.json, never changes the keys, and sends the Go key only to opencode.ai.
Pick a model
The composer’s model menu lists what OpenCode offers. For now Arakun limits it to four models:opencode-go/gemini-4-argon, the defaultopencode-go/kimi-k3.1-procloudflare-workers-ai/@cf/deepseek-ai/deepseek-v4.1-flash-1017cloudflare-workers-ai/@cf/zai-org/glm-5.3
ARAKUN_OPENCODE_ALL_MODELS=1 to see every model of every provider you signed in to. A model you set in your own OpenCode config wins over the default.
The model you pick carries over to the next session. The reasoning levels come from OpenCode and depend on the model. The chip next to the composer switches between OpenCode’s Build and Plan modes; what Build may do without asking is set in OpenCode’s config.
Usage
With an OpenCode Go key, the Usage tab shows Go’s 5-hour, weekly and monthly limits, and the sidebar card can show them too. Arakun sends a desktop notification when one passes 80% and when it is full. A full Go plan doesn’t block you: another provider can still take the prompt.Good to know
arakun agent new <prompt>starts an OpenCode session from a terminal, in the background. You can watch it in the sidebar.- With Sandbox agents on in Settings › Project, OpenCode runs in a sandbox.
What does not work yet
- The Usage tab shows no tokens or cost for OpenCode. OpenCode keeps its history in a database Arakun does not read.
- Subagents show as a Task call, not as sessions of their own.
- Removing a session from Arakun leaves OpenCode’s own copy of the conversation.
Common errors
opencode was not found on PATH or in ~/.local/bin
opencode was not found on PATH or in ~/.local/bin
Install OpenCode from opencode.ai, or point
ARAKUN_OPENCODE_BIN at the binary.OpenCode is not signed in
OpenCode is not signed in
Click Sign in in a terminal under the error, or run
opencode auth login. Pick OpenCode Go or another provider, paste its API key, then click Retry.OpenCode stopped responding
OpenCode stopped responding
The
opencode process ended. The error box shows the path of opencode.log; read it for the reason, then retry.