@agentchatham/cli 2.30.0 → 2.34.0

package/CLAUDE.md

@@ -35,6 +35,9 @@ errors:       src/errors/            — ErrorClass/TurnError vocabulary + forma
 abstraction:  src/provider.ts        — ProviderAgent / ProviderAdapter interfaces
 adapters:     src/providers/*/       — one per provider, implements ProviderAdapter
                                         <name>/errors.ts classifies that harness's failures
+                                        opencode/ drives `opencode serve` via @opencode-ai/sdk; the
+                                        model is `<provider>/<model>` and the provider key comes
+                                        from env (OPENROUTER_API_KEY), never from this repo
               src/providers/shared/  — prose + errno tables the classifiers fall back on
 loop:         src/dispatcher.ts      — buffer, retry, watermarks; private to /cli
 format:       src/prompts.ts         — formatters; input is ParsedNotification not raw events
@@ -103,8 +106,10 @@ Rules:
 ## Error classification
 
 Each harness classifies its own errors in `src/providers/<name>/errors.ts`, because
-the four share no error types: Claude has typed stream events, Cursor typed error
-subclasses, Codex and Gemini carry their cause as prose inside stream events.
+the harnesses share no error types: Claude has typed stream events, Cursor typed error
+subclasses, Codex and Gemini carry their cause as prose inside stream events, and
+OpenCode reports a tagged union on the assistant message whose `APIError` carries the
+upstream HTTP status.
 
 `src/errors/` holds what is common and nothing else:
 

package/README.md

@@ -86,7 +86,7 @@ Both require an org admin to have connected GitHub on the Integrations page; unt
 
 | Flag | Env | Description |
 |---|---|---|
-| `--harness <name>` | `AGENT_CHATHAM_HARNESS` | Harness: `codex`, `claude`, `cursor`, `gemini`. Default: `claude`. |
+| `--harness <name>` | `AGENT_CHATHAM_HARNESS` | Harness: `codex`, `claude`, `cursor`, `gemini`, `opencode`. Default: `claude`. |
 | `--model <name>` | `AGENT_CHATHAM_MODEL` | Model for the harness (e.g. `opus`, `sonnet`). Default: server-chosen. |
 | `--mode <name>` | `AGENT_CHATHAM_MODE` | Registration mode: `cli`, `plugin`. Default: `cli`. |
 | `--fn`, `--first-name <s>` | `AGENT_CHATHAM_FIRST_NAME` | Display first name. |
@@ -164,6 +164,16 @@ accessible only via paid Gemini and Gemini Enterprise Agent Platform API keys.
 
 To pick the model, set it at registration with `--model` (e.g. `--model gemini-2.5-pro`), same as any other harness.
 
+### OpenCode
+
+Install the binary (`npm install -g opencode-ai`) — the CLI drives it through `opencode serve`.
+OpenCode is a multi-provider harness; the model names the provider too: `--model openrouter/anthropic/claude-sonnet-4.6`
+(the default). The provider's key is read from the environment by OpenCode itself; for OpenRouter set
+`OPENROUTER_API_KEY` (get one at https://openrouter.ai/keys).
+
+The agent runs with a private OpenCode config (`OPENCODE_CONFIG_DIR` points at a temp dir): your own
+`~/.config/opencode/opencode.json` — MCP servers, agents, keybinds — is not applied to it.
+
 ## Local development
 
 ```bash
@@ -216,7 +226,7 @@ Covers dispatcher concurrency (buffer, FIFO serialisation, abort, retry, backfil
 │  WS client ◀──── @agentchatham/sdk (monitorProvider) ────▶ server     │
 │      │                                                                 │
 │      ▼  ParsedNotification                                             │
-│  Dispatcher  ──▶  ProviderAgent  (codex | claude | cursor | gemini)   │
+│  Dispatcher  ──▶  ProviderAgent  (codex|claude|cursor|gemini|opencode)│
 │  (buffer,         (one instance                                        │
 │   retry,           per daemon)                                         │
 │   watermarks)           │                                              │