Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
docs(llm-providers): document the opencode provider (#763)
Raniere Lima0a5c3ee388cd
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 08a74e62..527b71b4 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0## [Unreleased]+### Docs+- `docs/llm-providers.md` now covers the `opencode` LLM provider, which has+ shipped since 1.x but was missing from the recommended-defaults table:+ `OPENCODE_API_KEY` as the only credential, Go as the default endpoint, Zen+ via `AI_MEMORY_LLM_BASE_URL`, the built-in default model, per-catalogue+ model ids, and which model goes through the Responses endpoint (#763).+## [2.3.2] - 2026-09-20### Changeddiff --git a/docs/llm-providers.md b/docs/llm-providers.mdindex 424b68ad..6addd7c7 100644--- a/docs/llm-providers.md+++ b/docs/llm-providers.md@@ -49,6 +49,7 @@ Recommended defaults:| `codex` | `gpt-5.6-luna` | Reuse the Codex CLI-owned `auth.json`; access-token refresh remains owned by `codex app-server`. || `copilot` | `gpt-5.5` | GitHub Copilot Chat backend via `ai-memory auth login copilot` or `COPILOT_GITHUB_TOKEN`; requires a Copilot subscription. || `gemini` | `gemini-3.5-flash` | Google-hosted option with a generous free tier. |+| `opencode` | `claude-sonnet-4-6` | OpenCode Go or Zen via `OPENCODE_API_KEY`. Go is the default endpoint; `AI_MEMORY_LLM_BASE_URL` selects Zen. Set `AI_MEMORY_LLM_MODEL` to an id the chosen endpoint serves. || `openai-compat` | no default | OpenRouter, Atlas Cloud, OrcaRouter, Ollama, vLLM, LM Studio, and other compatible endpoints. |`openai-oauth` stores a refresh token in `<data_dir>/auth.json` and talks to@@ -80,6 +81,33 @@ Docker is not configured automatically: the Codex executable, `CODEX_HOME`,and its credential file must all exist in the same container/environment asai-memory.+`opencode` talks to OpenCode's gateway with the `sk-...` key from+`opencode.ai/auth`, read from `OPENCODE_API_KEY` only; it does not fall back+to `LLM_API_KEY`. It defaults to the **Go** endpoint,+`https://opencode.ai/zen/go/v1`: a subscription with a per-model monthly+allowance rather than per-token billing. Set+`AI_MEMORY_LLM_BASE_URL=https://opencode.ai/zen/v1` (or `llm_base_url` in+`config.toml`) for **Zen**'s pay-per-token catalogue. Model ids are per+catalogue and written plainly (`mimo-v2.5`, `glm-5.3-flash`), not in the+`opencode-go/<model>` form OpenCode's own client config uses. The built-in+default is `claude-sonnet-4-6`; Go ids such as `mimo-v2.5` or `glm-5.3-flash`+come from `AI_MEMORY_LLM_MODEL`, so set it to an id the endpoint you chose+serves. `gpt-5.6-luna` is sent through the Responses endpoint;+every other model uses Chat Completions. The provider sends the+`x-opencode-session` correlation header OpenCode asks for, one id per logical+operation, and its own `User-Agent`; `AI_MEMORY_LLM_HEADERS` overrides+either. `AI_MEMORY_LLM_REASONING_EFFORT` and `AI_MEMORY_LLM_TIMEOUT_SECS`+apply as for every other provider. `AI_MEMORY_LLM_PROVIDER` / `llm_provider`+also accept the historical aliases `opencode-zen` and `opencode_zen` for the+same provider (`llm-test --provider` takes only `opencode`); the endpoint is+chosen by the base URL, not the alias.++```bash+export AI_MEMORY_LLM_PROVIDER=opencode+export AI_MEMORY_LLM_MODEL=mimo-v2.5+ai-memory llm-test --provider opencode --model mimo-v2.5 --prompt "Reply with OK"+```+`anthropic-oauth` hits the same `/v1/messages` endpoint as `anthropic` butauthenticates with an OAuth bearer token instead of an API key. Run`claude setup-token` once, then set `AI_MEMORY_LLM_PROVIDER=anthropic-oauth` and