OpenCode Runner¶
This runner integrates with the OpenCode CLI. Shipped in Takopi v0.5.0.
Installation¶
npm i -g opencode-ai@latest
Configuration¶
Add to your takopi.toml:
[opencode]
model = "claude-sonnet" # optional
Usage¶
takopi opencode
Resume Format¶
Resume line format: `opencode --session ses_XXX`
The runner recognizes both --session and -s flags (with or without run).
Note: The resume line is meant to reopen the interactive TUI session. opencode run is headless and requires a message or command, so it is not the canonical resume command.
JSON Event Format¶
OpenCode outputs JSON events with the following types:
| Event Type | Description |
|---|---|
step_start |
Beginning of a processing step |
tool_use |
Tool invocation with input/output |
text |
Text output from the model |
step_finish |
End of a step (reason: "stop" or "tool-calls" when present) |
error |
Error event |
See stream-json-cheatsheet.md for detailed event format documentation.