feat(cli): add ocx opencode launcher

docs-site/astro.config.mjs

@@ -121,6 +121,7 @@ export default defineConfig({
             { label: "Codex App Model Picker", translations: { ko: "Codex App 모델 선택기", "zh-CN": "Codex App 模型选择器", ru: "Выбор модели в Codex App", ja: "Codex App モデルピッカー" }, slug: "guides/codex-app-models" },
             { label: "Model Ordering", translations: { ko: "모델 정렬에 관하여", "zh-CN": "模型排序", ru: "Сортировка моделей", ja: "モデルの並び順" }, slug: "guides/model-ordering" },
             { label: "Claude Code", translations: { ko: "Claude Code", "zh-CN": "Claude Code", ru: "Claude Code", ja: "Claude Code" }, slug: "guides/claude-code" },
+            { label: "opencode", translations: { ko: "opencode", "zh-CN": "opencode", ru: "opencode", ja: "opencode" }, slug: "guides/opencode" },
             { label: "Sidecars: Web Search & Vision", translations: { ko: "사이드카: 웹 검색 & 비전", "zh-CN": "边车：网络搜索与视觉", ru: "Сайдкары: веб-поиск и зрение", ja: "サイドカー: ウェブ検索 & ビジョン" }, slug: "guides/sidecars" },
             { label: "Web Dashboard", translations: { ko: "웹 대시보드", "zh-CN": "网页控制台", ru: "Веб-дашборд", ja: "ウェブダッシュボード" }, slug: "guides/web-dashboard" },
             { label: "Sub-agent Surface", translations: { ko: "서브에이전트 서피스", "zh-CN": "子代理界面", ru: "Интерфейс подагентов", ja: "サブエージェントサーフェス" }, slug: "guides/sub-agent-surface" },

docs-site/src/content/docs/guides/opencode.md

@@ -0,0 +1,95 @@
+---
+title: opencode
+description: Use any routed model from opencode — opencodex generates a provider config and points OPENCODE_CONFIG at it, leaving your own opencode.json untouched.
+---
+
+opencode reads its providers from a JSON config rather than environment variables, so there is
+no `ANTHROPIC_BASE_URL`-style slot to inject. `ocx opencode` bridges that gap: it generates a
+provider block from the proxy's visible catalog and points `OPENCODE_CONFIG` at the result.
+
+## Quickstart
+
+```bash
+ocx opencode
+```
+
+This ensures the proxy is running, writes `~/.opencodex/opencode-config.json`, and launches
+opencode with `OPENCODE_CONFIG` set to that file. Extra arguments pass through:
+`ocx opencode run "hello"`.
+
+Routed models appear in the picker under the `opencodex` provider:
+
+```
+opencodex/kiro/glm-5
+opencodex/gpt-5.6-sol      # native slugs stay unprefixed
+```
+
+## Your own config is never modified
+
+The launcher does not write to `~/.config/opencode/opencode.json`. Instead it reads your
+effective config, merges it forward into the generated copy, and overwrites only the
+`opencodex` provider key. Every other provider, plus unrelated top-level fields (`model`,
+`agents`, `keybinds`, `mcp`, …), is preserved verbatim.
+
+| Source | Behavior |
+| --- | --- |
+| `OPENCODE_CONFIG` already exported | Used as the base config, then superseded by the generated path |
+| `~/.config/opencode/opencode.json` (or `$XDG_CONFIG_HOME`) | Used as the base config when no explicit export exists |
+| Neither exists | A standalone config containing only the `opencodex` provider |
+| Base config is malformed | The launch is refused rather than silently dropping your settings |
+
+Comments and trailing commas are fine — opencode documents `opencode.json` as JSONC, and the
+launcher parses the same syntax the client accepts.
+
+Carrying your config forward means the command behaves identically whether opencode merges the
+`OPENCODE_CONFIG` layer or replaces it.
+
+### Project configs still win
+
+opencode loads a project-level `opencode.json` *after* the `OPENCODE_CONFIG` layer. If your
+project config defines `provider.opencodex`, it overrides the generated block and the child may
+talk to a stale base URL. The launcher cannot outrank that layer without writing to one of your
+files, so it prints a warning instead. Rename the project-level key to resolve it.
+
+## The admission key is not written to disk
+
+When the proxy requires an API key, the generated config carries opencode's `{env:…}` reference
+rather than the secret:
+
+```json
+"options": {
+  "baseURL": "http://127.0.0.1:10100/v1",
+  "apiKey": "{env:OPENCODEX_OPENCODE_API_KEY}"
+}
+```
+
+The real value is passed only through the child process environment. `OPENCODEX_API_AUTH_TOKEN`
+takes precedence over a configured API key, which is what a non-loopback bind requires.
+
+## Reverting
+
+Nothing to undo — the generated file lives in the opencodex config dir and is only consulted
+when the launcher sets `OPENCODE_CONFIG` for the child process. Run plain `opencode` and it
+reads your own config exactly as before.
+
+## Model limits
+
+`limit.context` is written only when the catalog reports an authoritative context window; when it
+does not, the whole `limit` block is omitted and opencode keeps its own defaults.
+
+opencode's schema rejects a `limit` block carrying `context` without `output`, and the catalog has
+no authoritative per-model output field, so an `output` budget of `32000` is emitted alongside it,
+clamped down to the context window so a small-context model is never given `output > context`.
+That figure exists to satisfy the schema — it is not a claim about any specific model's true
+maximum.
+
+The `opencodex` provider block is regenerated on every launch, so per-model tweaks made inside it
+will not survive. Keep custom entries under a provider key of your own instead.
+
+## Requirements
+
+opencode must be installed and on `PATH`:
+
+```bash
+npm install -g opencode-ai
+```

src/cli/help.ts

@@ -127,6 +127,18 @@ const helpEntries: Record<string, HelpEntry> = {
       "User-exported ANTHROPIC_* variables always take precedence.",
     ],
   },
+  opencode: {
+    usage: "ocx opencode [opencode args...]",
+    summary: "Launch opencode wired to the proxy (generated provider config).",
+    details: [
+      "Ensures the proxy is running, then execs `opencode` with OPENCODE_CONFIG pointed at a",
+      "generated config in the opencodex config dir. Your own opencode.json is never modified —",
+      "its settings are merged forward into the generated copy, and only the `opencodex`",
+      "provider key is overwritten.",
+      "Routed models appear in the model picker as opencodex/<provider>/<model>.",
+      "Stop using `ocx opencode` and plain `opencode` behaves exactly as before.",
+    ],
+  },
   restart: {
     usage: "ocx restart",
     summary: "Stop the proxy and restart it (background). Equivalent to stop + ensure.",
@@ -192,6 +204,7 @@ Usage:
   ocx account <sub>           Accounts/keys (list|current|use|refresh|auto-switch|remove|add-key)
   ocx models <sub>            List models; manage custom models (add|remove|list-custom)
   ocx claude [args...]        Launch Claude Code wired to the proxy (model discovery on)
+  ocx opencode [args...]      Launch opencode wired to the proxy (generated provider config)
   ocx help [command]          Show help
   ocx --version | -v          Print version
 

src/cli/index.ts

@@ -810,6 +810,10 @@ switch (command) {
       break;
     }
     process.exit(await cmdClaude(args.slice(1)));
+  }
+  case "opencode": {
+    const { cmdOpencode } = await import("./opencode");
+    process.exit(await cmdOpencode(args.slice(1)));
   }
     case "help":
   case "--help":