feat: opencode runner (#22)

Co-authored-by: banteg <4562643+banteg@users.noreply.github.com>
2026-01-02 09:57:19 -03:00
parent 1204524bef
commit 7c30674e53
9 changed files with 1189 additions and 0 deletions
@@ -0,0 +1,46 @@
+# OpenCode Runner
+
+This runner integrates with the [OpenCode CLI](https://github.com/sst/opencode).
+
+## Installation
+
+```bash
+npm i -g opencode-ai@latest
+```
+
+## Configuration
+
+Add to your `takopi.toml`:
+
+```toml
+[opencode]
+model = "claude-sonnet"  # optional
+```
+
+## Usage
+
+```bash
+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 [opencode-stream-json-cheatsheet.md](./opencode-stream-json-cheatsheet.md) for detailed event format documentation.