pennyrouter 0.2.26 → 0.2.28

package/README.md

@@ -23,7 +23,7 @@ npx pennyrouter status
 Installation opens a browser and requires login to the PennyRouter account that should own
 the new machine key. CLI installs no longer create anonymous ghost accounts.
 
-With no `--harness` flag, the interactive installer shows Claude Code and Codex. Detected
+With no `--harness` flag, the interactive installer shows Claude Code, Codex, and OpenCode. Detected
 tools start checked. The additional legacy integrations remain available through an explicit
 `--harness <id>` selection or `--all`.
 
@@ -41,10 +41,12 @@ directory to the user PATH:
 ```bash
 penny claude
 penny codex
+penny opencode
 ```
 
-Arguments are passed through to the native harness, so commands such as `penny claude --resume`
-and `penny codex resume --last` work normally. By default, bare `claude` and `codex` remain
+Arguments are passed through to the native harness, so commands such as `penny claude --resume`,
+`penny codex resume --last`, and `penny opencode --continue` work normally. By default, bare
+`claude`, `codex`, and `opencode` remain
 completely native; their normal configuration files are not redirected. Choose the installer's
 "make PennyRouter the default" option, or pass `--make-default`, to retain the original global
 routing behavior.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pennyrouter",
-  "version": "0.2.26",
+  "version": "0.2.28",
   "description": "Install and manage PennyRouter local coding-agent integrations.",
   "homepage": "https://pennyrouter.com",
   "bugs": {
@@ -24,7 +24,7 @@
   ],
   "scripts": {
     "start": "node ./bin/pennyrouter.js",
-    "check": "node --check ./bin/pennyrouter.js && node --check ./bin/penny.js && find src -name '*.js' -print0 | xargs -0 -n1 node --check && node src/session.test.js && node src/statusline.test.js && node src/harnesses/claude-code.test.js && node src/harnesses/codex.test.js && node src/launch.test.js && node src/thread-session.test.js && node src/thread-session-codex.test.js && node src/mcp-register.test.js && node src/mcp.test.js"
+    "check": "node --check ./bin/pennyrouter.js && node --check ./bin/penny.js && find src -name '*.js' -print0 | xargs -0 -n1 node --check && node src/session.test.js && node src/statusline.test.js && node src/harnesses/claude-code.test.js && node src/harnesses/codex.test.js && node src/harnesses/opencode.test.js && node src/launch.test.js && node src/thread-session.test.js && node src/thread-session-codex.test.js && node src/mcp-register.test.js && node src/mcp.test.js"
   },
   "license": "MIT"
 }

package/src/cli.js

@@ -68,7 +68,7 @@ const HARNESS_BY_ID = {
 };
 
 const SUPPORTED_HARNESS_IDS = Object.keys(HARNESS_BY_ID).join(",");
-const DEFAULT_INSTALL_HARNESS_IDS = ["claude-code", "codex"];
+const DEFAULT_INSTALL_HARNESS_IDS = ["claude-code", "codex", "opencode"];
 const CLAUDE_PROVIDER_OPTIONS = [
   { id: "subscription", name: "Claude subscription" },
   { id: "anthropic-api", name: "Anthropic API key" },
@@ -521,8 +521,9 @@ export async function install(flags = {}) {
   if (flags.dryRun) {
     const defaultRouting = await chooseDefaultRouting(flags, selected, manifest);
     for (const harness of selected) {
-      const explicit = ["claude-code", "codex"].includes(harness.id);
-      const command = harness.id === "claude-code" ? "penny claude" : "penny codex";
+      const explicit = ["claude-code", "codex", "opencode"].includes(harness.id);
+      const command = harness.id === "claude-code"
+        ? "penny claude" : harness.id === "codex" ? "penny codex" : "penny opencode";
       console.log(`Will install on ${harness.name}${explicit ? ` via ${command}` : installNoteForHarness(harness.id)}.`);
       if (defaultRouting.get(harness.id)) {
         console.log(`Will also route bare ${harness.id === "claude-code" ? "claude" : harness.id} through PennyRouter.`);
@@ -615,7 +616,7 @@ export async function install(flags = {}) {
   // choose the visible command behavior with all relevant context in front of them.
   const defaultRouting = await chooseDefaultRouting(flags, selected, manifest);
 
-  const launchable = selected.filter((harness) => ["claude-code", "codex"].includes(harness.id));
+  const launchable = selected.filter((harness) => ["claude-code", "codex", "opencode"].includes(harness.id));
   let runtimeResult = null;
   if (launchable.length > 0) {
     runtimeResult = await installPennyRuntime({ updatePath: !flags.noPathUpdate });
@@ -629,7 +630,7 @@ export async function install(flags = {}) {
       const existingRecord = (manifest.installations || []).find(
         (candidate) => candidate.harness === harness.id,
       );
-      const supportsPennyCommand = ["claude-code", "codex"].includes(harness.id);
+      const supportsPennyCommand = ["claude-code", "codex", "opencode"].includes(harness.id);
       const makeDefault = defaultRouting.get(harness.id) ?? true;
       const hadGlobalRouting = Boolean(existingRecord && existingRecord.default_routing !== false);
       if (["claude-code", "codex"].includes(harness.id) && (makeDefault || hadGlobalRouting)) {
@@ -677,7 +678,9 @@ export async function install(flags = {}) {
       if (supportsPennyCommand) {
         record.launch_available = true;
         record.launch_config_path = compactHome(
-          harness.id === "claude-code" ? claudeLaunchSettingsPath() : codexLaunchProfilePath(),
+            harness.id === "claude-code"
+              ? claudeLaunchSettingsPath()
+              : harness.id === "codex" ? codexLaunchProfilePath() : null,
         );
         record.default_routing = Boolean(makeDefault);
       }
@@ -717,9 +720,12 @@ export async function install(flags = {}) {
   for (const record of records) {
     const harness = HARNESS_BY_ID[record.harness];
     if (record.launch_available) {
-      const command = record.harness === "claude-code" ? "penny claude" : "penny codex";
-      const native = record.harness === "claude-code" ? "claude" : "codex";
-      const harnessName = record.harness === "claude-code" ? "Claude Code" : "Codex";
+      const command = record.harness === "claude-code"
+        ? "penny claude" : record.harness === "codex" ? "penny codex" : "penny opencode";
+      const native = record.harness === "claude-code" ? "claude"
+        : record.harness === "codex" ? "codex" : "opencode";
+      const harnessName = record.harness === "claude-code" ? "Claude Code"
+        : record.harness === "codex" ? "Codex" : "OpenCode";
       const commandWidth = Math.max(command.length, native.length) + 2;
       console.log("");
       console.log(color(`How to Run ${harnessName}`, "bold"));
@@ -928,7 +934,7 @@ async function update(flags) {
 
   const failures = [];
   let runtimeResult = null;
-  if (targets.some((record) => ["claude-code", "codex"].includes(record.harness))) {
+  if (targets.some((record) => ["claude-code", "codex", "opencode"].includes(record.harness))) {
     runtimeResult = await installPennyRuntime({ updatePath: !flags.noPathUpdate });
   }
 
@@ -937,7 +943,7 @@ async function update(flags) {
     if (!harness) continue;
 
     await runHarnessJob(failures, record.harness, "update", async () => {
-      const supportsPennyCommand = ["claude-code", "codex"].includes(record.harness);
+      const supportsPennyCommand = ["claude-code", "codex", "opencode"].includes(record.harness);
       // An update rewrites the harness's own config only when that config is ours to
       // rewrite — i.e. the bare command still routes through the gateway. In penny-only
       // mode the harness config belongs to the user and we touch just the launch profile.
@@ -1604,7 +1610,8 @@ async function status() {
       console.log(`  Upstream proxy: ${record.proxy_base_url}${note}`);
     }
     if (record.launch_available) {
-      const command = record.harness === "claude-code" ? "penny claude" : "penny codex";
+      const command = record.harness === "claude-code"
+        ? "penny claude" : record.harness === "codex" ? "penny codex" : "penny opencode";
       console.log(`  command: ${command}`);
       console.log(`  bare command: ${record.default_routing ? "PennyRouter" : "native"}`);
     }

package/src/harnesses/claude-code.js

@@ -17,15 +17,18 @@ export const CLAUDE_CODE_MODELS = {
   sonnet: "claude-sonnet-5[1m]",
   opus: "claude-opus-5[1m]",
   fable: "claude-fable-5[1m]",
-  custom: "Penny Custom",             // -> dynamic (PennyRouter cost-routing)
 };
 const CLAUDE_CODE_MODEL_PRESENTATION = {
-  haiku: { name: "Haiku 4.5 (PennyRouter)", description: "Fast, economical Claude model · 200K context" },
-  sonnet: { name: "Sonnet 5 (PennyRouter)", description: "Balanced Claude model · 1M context" },
-  opus: { name: "Opus 5 (PennyRouter)", description: "Most capable Claude model · 1M context" },
-  fable: { name: "Fable 5 (PennyRouter)", description: "Claude model · 1M context" },
+  haiku: { name: "Haiku 4.5", description: "Fast, economical Claude model · 200K context" },
+  sonnet: { name: "Sonnet 5", description: "Balanced Claude model · 1M context" },
+  opus: { name: "Opus 5", description: "Most capable Claude model · 1M context" },
+  fable: { name: "Fable 5", description: "Claude model · 1M context" },
 };
 const LEGACY_PINNED_MODEL_IDS = {
+  "Haiku 4.5": CLAUDE_CODE_MODELS.haiku,
+  "Sonnet 5": CLAUDE_CODE_MODELS.sonnet,
+  "Opus 5": CLAUDE_CODE_MODELS.opus,
+  "Fable 5": CLAUDE_CODE_MODELS.fable,
   "Haiku 4.5 (PennyRouter)": CLAUDE_CODE_MODELS.haiku,
   "Sonnet 5 (PennyRouter)": CLAUDE_CODE_MODELS.sonnet,
   "Opus 5 (PennyRouter)": CLAUDE_CODE_MODELS.opus,
@@ -86,6 +89,7 @@ export const claudeCodeHarness = {
     // Anthropic API key. Clear any stale key so it doesn't take precedence.
     current.env.ANTHROPIC_AUTH_TOKEN = apiKey;
     delete current.env.ANTHROPIC_API_KEY;
+    current.env.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1";
     // Claude Code displays these env values directly in its model picker; the
     // gateway decodes the friendly labels into bundle/profile overrides.
     current.env.ANTHROPIC_DEFAULT_OPUS_MODEL = CLAUDE_CODE_MODELS.opus;
@@ -93,6 +97,9 @@ export const claudeCodeHarness = {
     current.env.ANTHROPIC_DEFAULT_HAIKU_MODEL = CLAUDE_CODE_MODELS.haiku;
     current.env.ANTHROPIC_DEFAULT_FABLE_MODEL = CLAUDE_CODE_MODELS.fable;
     writeClaudeCodeModelPresentation(current.env);
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION;
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION_NAME;
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION;
     // This is global, not per-model. Leave it unset so Claude Code uses each native id's
     // real context limit instead of incorrectly giving Haiku a 1M window.
     delete current.env.CLAUDE_CODE_MAX_CONTEXT_TOKENS;
@@ -138,11 +145,15 @@ export const claudeCodeHarness = {
     current.env.ANTHROPIC_AUTH_TOKEN = apiKey;
     // Single credential only: no stale api key, no separate Anthropic bearer.
     delete current.env.ANTHROPIC_API_KEY;
+    current.env.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1";
     current.env.ANTHROPIC_DEFAULT_OPUS_MODEL = CLAUDE_CODE_MODELS.opus;
     current.env.ANTHROPIC_DEFAULT_SONNET_MODEL = CLAUDE_CODE_MODELS.sonnet;
     current.env.ANTHROPIC_DEFAULT_HAIKU_MODEL = CLAUDE_CODE_MODELS.haiku;
     current.env.ANTHROPIC_DEFAULT_FABLE_MODEL = CLAUDE_CODE_MODELS.fable;
     writeClaudeCodeModelPresentation(current.env);
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION;
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION_NAME;
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION;
     // This is global, not per-model. Leave it unset so Claude Code uses each native id's
     // real context limit instead of incorrectly giving Haiku a 1M window.
     delete current.env.CLAUDE_CODE_MAX_CONTEXT_TOKENS;
@@ -184,11 +195,15 @@ export const claudeCodeHarness = {
     // Authorization bearer token is forwarded by the gateway to Anthropic.
     current.env.ANTHROPIC_API_KEY = pennyKey;
     current.env.ANTHROPIC_AUTH_TOKEN = anthropicAuthToken;
+    current.env.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1";
     current.env.ANTHROPIC_DEFAULT_OPUS_MODEL = CLAUDE_CODE_MODELS.opus;
     current.env.ANTHROPIC_DEFAULT_SONNET_MODEL = CLAUDE_CODE_MODELS.sonnet;
     current.env.ANTHROPIC_DEFAULT_HAIKU_MODEL = CLAUDE_CODE_MODELS.haiku;
     current.env.ANTHROPIC_DEFAULT_FABLE_MODEL = CLAUDE_CODE_MODELS.fable;
     writeClaudeCodeModelPresentation(current.env);
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION;
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION_NAME;
+    delete current.env.ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION;
     // This is global, not per-model. Leave it unset so Claude Code uses each native id's
     // real context limit instead of incorrectly giving Haiku a 1M window.
     delete current.env.CLAUDE_CODE_MAX_CONTEXT_TOKENS;

package/src/harnesses/opencode.js

@@ -8,11 +8,12 @@ import {
   readText,
   writeJsonFile,
 } from "../state.js";
-import { PENNYROUTER_MODEL_CHOICES } from "./shared.js";
-
 const JSONC_PATH = "~/.config/opencode/opencode.jsonc";
 const JSON_PATH = "~/.config/opencode/opencode.json";
 const MODEL_STATE_PATH = "~/.local/state/opencode/model.json";
+const FALLBACK_MODEL_CHOICES = [
+  { id: "pennyrouter/auto", name: "PennyRouter Auto" },
+];
 
 export const opencodeHarness = {
   id: "opencode",
@@ -35,7 +36,7 @@ export const opencodeHarness = {
     };
   },
 
-  async install({ apiKey, gatewayBaseUrl, plan }) {
+  async install({ apiKey, gatewayBaseUrl, plan, models }) {
     const configPath = compactHome(plan.configPath);
     const backupPath = await backupFile(configPath, "opencode");
     const current = await readConfig(configPath);
@@ -44,18 +45,29 @@ export const opencodeHarness = {
       npm: "@ai-sdk/openai-compatible",
       name: "PennyRouter",
       options: {
-        baseURL: `${gatewayBaseUrl}/v1`,
+        baseURL: `${String(gatewayBaseUrl).replace(/\/+$/, "")}/v1`,
         apiKey,
       },
       models: Object.fromEntries(
-        PENNYROUTER_MODEL_CHOICES.map((model) => [model.id, { name: model.name }]),
+        (models || await fetchOpenCodeModels(gatewayBaseUrl)).map((model) => [
+          opencodeModelId(model.id),
+          { name: model.name, ...(model.description ? { description: model.description } : {}) },
+        ]),
       ),
     };
 
     await atomicWrite(configPath, `${JSON.stringify(current, null, 2)}\n`);
 
     const modelBackupPath = await backupFile(MODEL_STATE_PATH, "opencode-model");
-    await writeJsonFile(MODEL_STATE_PATH, { recent: [], favorite: [], variant: {} });
+    const model = (await readJsonFile(MODEL_STATE_PATH, null)) || {};
+    model.recent = removePennyRouterModels(model.recent);
+    model.favorite = removePennyRouterModels(model.favorite);
+    if (model.variant && typeof model.variant === "object") {
+      for (const [key, value] of Object.entries(model.variant)) {
+        if (isPennyRouterModel(key) || isPennyRouterModel(value)) delete model.variant[key];
+      }
+    }
+    await writeJsonFile(MODEL_STATE_PATH, model);
 
     return {
       harness: "opencode",
@@ -136,7 +148,40 @@ function stripJsonComments(text) {
     result += char;
   }
 
-  return result;
+  return result.replace(/,\s*([}\]])/g, "$1");
+}
+
+export function opencodeModelId(modelId) {
+  return modelId;
+}
+
+export async function fetchOpenCodeModels(gatewayBaseUrl) {
+  try {
+    const response = await fetch(`${String(gatewayBaseUrl).replace(/\/+$/, "")}/v1/models`);
+    if (!response.ok) throw new Error(`model catalog returned ${response.status}`);
+    const payload = await response.json();
+    const models = Array.isArray(payload?.data)
+      ? payload.data
+        .filter((model) => typeof model?.id === "string" && model.id.startsWith("pennyrouter/"))
+        .map((model) => ({
+          id: model.id,
+          name: model.display_name || openCodeModelName(model.id),
+          description: model.description,
+        }))
+      : [];
+    if (models.length > 0) return models;
+  } catch {}
+  return FALLBACK_MODEL_CHOICES;
+}
+
+function openCodeModelName(modelId) {
+  const suffix = opencodeModelId(modelId);
+  if (suffix === "auto") return "PennyRouter Auto";
+  return `PennyRouter ${suffix
+    .split(/[-:]/)
+    .filter(Boolean)
+    .map((part) => part[0].toUpperCase() + part.slice(1))
+    .join(" ")}`;
 }
 
 function removePennyRouterModels(value) {

package/src/harnesses/opencode.test.js

@@ -0,0 +1,82 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+import { opencodeHarness, opencodeModelId } from "./opencode.js";
+
+const ENV_KEYS = ["HOME", "XDG_STATE_HOME"];
+
+async function main() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), "pr-opencode-test-"));
+  const previous = Object.fromEntries(ENV_KEYS.map((key) => [key, process.env[key]]));
+  const home = path.join(root, "home");
+  const configPath = path.join(home, ".config", "opencode", "opencode.jsonc");
+  const modelStatePath = path.join(home, ".local", "state", "opencode", "model.json");
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.mkdirSync(path.dirname(modelStatePath), { recursive: true });
+  fs.writeFileSync(configPath, [
+    "{",
+    '  "$schema": "https://opencode.ai/config.json",',
+    '  "provider": {',
+    '    "custom": { "models": { "model-a": {} } },',
+    "  },",
+    "}",
+    "",
+  ].join("\n"));
+  fs.writeFileSync(modelStatePath, JSON.stringify({
+    recent: ["pennyrouter/old", "custom/model-a"],
+    favorite: ["pennyrouter/old"],
+    variant: { "pennyrouter/old": { value: "pennyrouter/old" }, "custom/model-a": {} },
+  }));
+  Object.assign(process.env, { HOME: home, XDG_STATE_HOME: path.join(home, ".local", "state") });
+
+  try {
+    assert.equal(opencodeModelId("pennyrouter/auto"), "pennyrouter/auto");
+    assert.equal(opencodeModelId("custom/model-a"), "custom/model-a");
+    const plan = await opencodeHarness.planInstall();
+    const record = await opencodeHarness.install({
+      apiKey: "pr-test",
+      gatewayBaseUrl: "https://api.pennyrouter.com/",
+      plan,
+      models: [
+        { id: "pennyrouter/penny-core:premium", name: "Penny Core" },
+        { id: "pennyrouter/penny-speed:standard", name: "Penny Speed" },
+        { id: "pennyrouter/penny-power:premium", name: "Penny Power" },
+        { id: "pennyrouter/auto", name: "Penny Custom" },
+      ],
+    });
+    const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    assert.equal(config.provider.custom.models["model-a"] !== undefined, true);
+    assert.deepEqual(Object.keys(config.provider.pennyrouter.models), [
+      "pennyrouter/penny-core:premium",
+      "pennyrouter/penny-speed:standard",
+      "pennyrouter/penny-power:premium",
+      "pennyrouter/auto",
+    ]);
+    assert.equal(config.provider.pennyrouter.options.baseURL, "https://api.pennyrouter.com/v1");
+    assert.deepEqual(JSON.parse(fs.readFileSync(modelStatePath, "utf8")).recent, ["custom/model-a"]);
+
+    await opencodeHarness.uninstall(record);
+    const restored = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    assert.equal(restored.provider.pennyrouter, undefined);
+    assert.deepEqual(restored.provider.custom.models, { "model-a": {} });
+    const model = JSON.parse(fs.readFileSync(modelStatePath, "utf8"));
+    assert.deepEqual(model.recent, ["custom/model-a"]);
+    assert.deepEqual(model.favorite, []);
+    assert.deepEqual(model.variant, { "custom/model-a": {} });
+  } finally {
+    for (const key of ENV_KEYS) {
+      if (previous[key] === undefined) delete process.env[key];
+      else process.env[key] = previous[key];
+    }
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+
+  console.log("opencode.test.js: all checks passed");
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/src/launch.js

@@ -21,6 +21,8 @@ const PATH_START = "# >>> pennyrouter PATH >>>";
 const PATH_END = "# <<< pennyrouter PATH <<<";
 const CODEX_PROFILE_MARKER = "# PennyRouter per-command profile (managed; no secrets)";
 const CLAUDE_COMMAND_MARKER = "<!-- PennyRouter managed Claude command -->";
+const TERMINAL_TITLE_REFRESH_MS = 1000;
+const TERMINAL_STATUS_REFRESH_MS = 15000;
 
 export function pennyConfigDir() {
   if (process.platform === "win32") {
@@ -254,9 +256,93 @@ export function renderCodexLaunchProfile({ gatewayBaseUrl, subscriptionAuth }) {
     "supports_websockets = false",
     ...authLines,
     "",
+    "[tui]",
+    // Penny owns the live terminal title while this profile is running. An empty
+    // list disables Codex's default activity/project title so the two writers do
+    // not race each other.
+    "terminal_title = []",
+    "",
   ].join("\n");
 }
 
+function terminalTitle(text) {
+  // OSC titles are interpreted by the terminal, so remove control characters and
+  // the OSC terminators rather than allowing gateway-provided text into the escape.
+  const safe = String(text).replace(/[\u0000-\u001f\u007f\u001b]/g, " ").slice(0, 240);
+  return `\u001b]0;${safe}\u0007`;
+}
+
+function writeTerminalTitle(title) {
+  if (process.stdout.isTTY) process.stdout.write(terminalTitle(title));
+}
+
+function renderPennyTerminalTitle(status) {
+  const parts = ["PennyRouter"];
+  if (status?.model_display_name) parts.push(status.model_display_name);
+  else if (status?.model) parts.push(status.model);
+  if (status?.auth_mode) parts.push(`(${status.auth_mode})`);
+  parts.push(renderCacheWarmth(status));
+  return parts.join(" · ");
+}
+
+function renderCacheWarmth(status) {
+  const expiresAt = status?.cache_expires_at;
+  if (typeof expiresAt !== "number" || !Number.isFinite(expiresAt) || expiresAt <= 0) {
+    return "❄️ cold";
+  }
+  const remaining = Math.floor(expiresAt - Date.now() / 1000);
+  if (remaining <= 0) return "❄️ cold";
+  const minutes = Math.floor(remaining / 60);
+  const seconds = remaining % 60;
+  return `🔥 ${minutes}:${String(seconds).padStart(2, "0")}`;
+}
+
+/**
+ * Keep the terminal/tab title useful while `penny codex` owns the foreground TTY.
+ * This is deliberately local and best-effort: failure to poll the gateway must never
+ * affect Codex, and non-TTY invocations (CI, pipes) receive no escape sequences.
+ */
+export function startPennyTerminalTitle({ gatewayBaseUrl, apiKey }) {
+  if (!process.stdout.isTTY) return () => {};
+
+  let status = null;
+  let stopped = false;
+  let statusInFlight = false;
+
+  const refreshStatus = async () => {
+    if (stopped || statusInFlight || !gatewayBaseUrl || !apiKey) return;
+    statusInFlight = true;
+    try {
+      const response = await fetch(`${String(gatewayBaseUrl).replace(/\/$/, "")}/v1/penny/statusline`, {
+        headers: { "x-api-key": apiKey },
+        signal: AbortSignal.timeout(4000),
+      });
+      if (response.ok) status = await response.json();
+    } catch {
+      // The title remains useful with its local timer when the gateway is unavailable.
+    } finally {
+      statusInFlight = false;
+    }
+  };
+
+  const tick = () => writeTerminalTitle(renderPennyTerminalTitle(status));
+  const timer = setInterval(tick, TERMINAL_TITLE_REFRESH_MS);
+  const statusTimer = setInterval(refreshStatus, TERMINAL_STATUS_REFRESH_MS);
+  timer.unref?.();
+  statusTimer.unref?.();
+  void refreshStatus();
+  tick();
+
+  return () => {
+    if (stopped) return;
+    stopped = true;
+    clearInterval(timer);
+    clearInterval(statusTimer);
+    // Let the shell or terminal choose its normal title again after Codex exits.
+    writeTerminalTitle("");
+  };
+}
+
 async function writeClaudeLaunchSettings() {
   const native = (await readJsonFile(join(homeDir(), ".claude", "settings.json"), null)) || {};
   const overlay = { disableClaudeAiConnectors: true };
@@ -330,6 +416,11 @@ export async function configurePennyHarness(harness, {
       enabled: true,
       subscription_auth: Boolean(subscriptionAuth),
     };
+  } else if (harness === "opencode") {
+    // OpenCode owns its provider and statusline configuration. The launcher only
+    // records that the Penny command is enabled; its existing OpenCode config is
+    // left untouched.
+    config.harnesses.opencode = { enabled: true };
   } else {
     throw new Error(`The penny command does not support ${harness}.`);
   }
@@ -433,16 +524,17 @@ export function buildPennyInvocation(harness, args, config) {
     const models = item.models || {};
     env.ANTHROPIC_BASE_URL = config.gateway_base_url;
     env.ANTHROPIC_AUTH_TOKEN = config.api_key;
+    // Ask Claude Code to discover the gateway's model catalog at startup. The gateway
+    // advertises Penny-facing ids in /v1/models; this is separate from inference routing.
+    env.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1";
     delete env.ANTHROPIC_API_KEY;
     if (models.haiku) env.ANTHROPIC_DEFAULT_HAIKU_MODEL = upgradeClaudeCodeModelValue(models.haiku);
     if (models.sonnet) env.ANTHROPIC_DEFAULT_SONNET_MODEL = upgradeClaudeCodeModelValue(models.sonnet);
     if (models.opus) env.ANTHROPIC_DEFAULT_OPUS_MODEL = upgradeClaudeCodeModelValue(models.opus);
     if (models.fable) env.ANTHROPIC_DEFAULT_FABLE_MODEL = upgradeClaudeCodeModelValue(models.fable);
-    if (models.custom) {
-      env.ANTHROPIC_CUSTOM_MODEL_OPTION = upgradeClaudeCodeModelValue(models.custom);
-      if (models.custom_name) env.ANTHROPIC_CUSTOM_MODEL_OPTION_NAME = models.custom_name;
-      if (models.custom_description) env.ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION = models.custom_description;
-    }
+    delete env.ANTHROPIC_CUSTOM_MODEL_OPTION;
+    delete env.ANTHROPIC_CUSTOM_MODEL_OPTION_NAME;
+    delete env.ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION;
     writeClaudeCodeModelPresentation(env);
     // Per-model limits must come from Claude Code's recognized native model ids. This
     // global override would incorrectly give Haiku the 1M window.
@@ -456,7 +548,10 @@ export function buildPennyInvocation(harness, args, config) {
   if (harness === "codex") {
     return { command: "codex", args: ["--profile", "pennyrouter", ...args], env };
   }
-  throw new Error(`Unknown Penny harness "${harness}". Try penny claude or penny codex.`);
+  if (harness === "opencode") {
+    return { command: "opencode", args, env };
+  }
+  throw new Error(`Unknown Penny harness "${harness}". Try penny claude, penny codex, or penny opencode.`);
 }
 
 async function waitForChild(child) {
@@ -469,11 +564,11 @@ async function waitForChild(child) {
 export async function runPenny(argv = process.argv.slice(2)) {
   const harness = argv[0];
   if (!harness || harness === "help" || harness === "--help" || harness === "-h") {
-    console.log("Usage: penny <claude|codex> [native arguments...]");
+    console.log("Usage: penny <claude|codex|opencode> [native arguments...]");
     return 0;
   }
-  if (!(["claude", "codex"].includes(harness))) {
-    throw new Error(`Unknown harness "${harness}". Try penny claude or penny codex.`);
+  if (!["claude", "codex", "opencode"].includes(harness)) {
+    throw new Error(`Unknown harness "${harness}". Try penny claude, penny codex, or penny opencode.`);
   }
   const config = await loadPennyConfig();
   const invocation = buildPennyInvocation(harness, argv.slice(1), config);
@@ -483,7 +578,14 @@ export async function runPenny(argv = process.argv.slice(2)) {
     stdio: "inherit",
     shell: process.platform === "win32",
   });
+  const stopTerminalTitle = ["codex", "opencode"].includes(harness)
+    ? startPennyTerminalTitle({
+        gatewayBaseUrl: config.gateway_base_url,
+        apiKey: config.api_key,
+      })
+    : () => {};
   const result = await waitForChild(child);
+  stopTerminalTitle();
   if (result.signal) return 128 + (osConstants.signals[result.signal] || 0);
   return result.code ?? 1;
 }

package/src/launch.test.js

@@ -83,6 +83,10 @@ async function main() {
       gatewayBaseUrl: "https://gateway.example/",
       subscriptionAuth: true,
     });
+    await configurePennyHarness("opencode", {
+      apiKey: "pr-super-secret",
+      gatewayBaseUrl: "https://gateway.example/",
+    });
 
     assert.equal(fs.readFileSync(path.join(home, ".claude", "settings.json"), "utf8"), nativeClaude);
     assert.equal(fs.readFileSync(path.join(home, ".codex", "config.toml"), "utf8"), nativeCodex);
@@ -94,6 +98,7 @@ async function main() {
     assert.equal(config.api_key, "pr-super-secret");
     const codexProfile = fs.readFileSync(codexLaunchProfilePath(), "utf8");
     assert.ok(codexProfile.includes('env_http_headers = { "x-pennyrouter-key" = "PENNYROUTER_API_KEY" }'));
+    assert.ok(codexProfile.includes("[tui]\nterminal_title = []"));
     assert.ok(!codexProfile.includes("pr-super-secret"));
     assert.ok(!rc.includes("pr-super-secret"));
 
@@ -103,18 +108,25 @@ async function main() {
     assert.ok(!claude.args.includes("--plugin-dir"));
     assert.equal(claude.env.ANTHROPIC_AUTH_TOKEN, "pr-super-secret");
     assert.equal(claude.env.ANTHROPIC_BASE_URL, "https://gateway.example/");
+    assert.equal(claude.env.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY, "1");
     // 1M-capable slots carry the `[1m]` suffix; Haiku has no 1M variant and stays bare.
     // Per-slot suffixes, not the global CLAUDE_CODE_MAX_CONTEXT_TOKENS override, which
     // would wrongly hand Haiku a 1M window too.
     assert.equal(claude.env.ANTHROPIC_DEFAULT_OPUS_MODEL, "claude-opus-5[1m]");
     assert.equal(claude.env.ANTHROPIC_DEFAULT_HAIKU_MODEL, "claude-haiku-4-5-20251001");
-    assert.equal(claude.env.ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME, "Haiku 4.5 (PennyRouter)");
+    assert.equal(claude.env.ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME, "Haiku 4.5");
     assert.equal(claude.env.ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION, "Fast, economical Claude model · 200K context");
     assert.equal(claude.env.CLAUDE_CODE_MAX_CONTEXT_TOKENS, undefined);
 
     const codex = buildPennyInvocation("codex", ["resume", "--last"], config);
     assert.deepEqual(codex.args, ["--profile", "pennyrouter", "resume", "--last"]);
     assert.equal(codex.env.PENNYROUTER_API_KEY, "pr-super-secret");
+    const opencode = buildPennyInvocation("opencode", ["--continue"], config);
+    assert.deepEqual(opencode, {
+      command: "opencode",
+      args: ["--continue"],
+      env: opencode.env,
+    });
     assert.throws(() => buildPennyInvocation("claude", ["--settings=x"], config), /manages --settings/);
     assert.throws(() => buildPennyInvocation("codex", ["-p", "other"], config), /manages --profile/);
 
@@ -147,6 +159,7 @@ async function main() {
     assert.ok(fs.existsSync(codexLaunchProfilePath()));
     assert.ok(fs.existsSync(pennyShimPath()));
     await removePennyHarness("codex");
+    await removePennyHarness("opencode");
     await removePennyRuntime();
     assert.ok(!fs.existsSync(pennyShimPath()));
     assert.ok(!fs.existsSync(pennyRuntimeDir()));

package/src/session.js

@@ -97,7 +97,7 @@ export async function probeClaudeCodeGateway({ gatewayBaseUrl, apiKey }) {
         "anthropic-beta": "compact-2026-01-12",
       },
       body: JSON.stringify({
-        model: "Sonnet 5 (PennyRouter)",
+        model: "Sonnet 5",
         max_tokens: 1,
         stream: false,
         messages: [{ role: "user", content: "Reply OK." }],