OpenCode Runner

This runner integrates with the OpenCode CLI. Shipped in Untether v0.5.0.

Installation

npm i -g opencode-ai@latest

Configuration

Add to your untether.toml:

=== “untether config”

```sh
untether config set opencode.model "claude-sonnet"
```

=== “toml”

```toml
[opencode]
model = "claude-sonnet"  # optional
```

Usage

untether 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.