catherd-cli 0.2.0 → 1.0.0

package/README.md

@@ -6,27 +6,34 @@
  (")(")
 ```
 
-Autopilot builds from your own Claude Code session. Claude plans and verifies, Codex and opencode
-workers write the code, and [Jev](https://typesafe.ai) picks the model and effort for each piece
+Autopilot builds from your own Claude Code session. Claude plans and verifies, Codex, opencode or
+headless Claude Code workers write the code, and [Jev](https://typesafe.ai) picks the model and effort for each piece
 of work, climbing a ladder only when a cheaper rung falls short.
 
 - **Your harness, as you set it up.** Every role runs in its vendor's own CLI with your config,
   hooks, skills and `AGENTS.md`. Isolation is an opt-in toggle per profile and harness, for when
   you'd rather save the tokens your customizations cost.
-- **Claude roles stay native.** Claude models run as ordinary Claude Code subagents; Codex and
-  opencode run through catherd's MCP server.
+- **Claude roles stay native.** `claude:` rungs run as ordinary Claude Code subagents; Codex,
+  opencode and headless `claude-code:` rungs run through catherd's MCP server.
 - **Survives restarts.** Workers are detached processes writing straight to disk, so a dropped
   MCP server never loses a run.
-- **Guard rails for autopilot.** Quota failover to another backend, a preflight check before any
+- **Guard rails for autopilot.** Quota failover to a rung on another quota, a preflight check before any
   worker starts, per-repo knowledge carried between runs, and a run budget.
 
 ## Requirements
 
 - [Bun](https://bun.sh) ≥ 1.4
 - [Claude Code](https://claude.com/claude-code) (desktop app or CLI)
-- At least one worker backend: [Codex CLI](https://github.com/openai/codex) and/or
-  [opencode](https://opencode.ai), logged in
-- A TypeSafe API key for Jev, in `TYPESAFE_API_KEY` or `~/.config/typesafe/api_key`
+- At least one worker backend, logged in:
+  - [Codex CLI](https://github.com/openai/codex) 0.157.0 or newer
+  - [opencode](https://opencode.ai) **v2**, 2.0.16 or newer: `curl -fsSL https://opencode.ai/v2/install | bash`
+    (the npm package `opencode-ai` is v1 and is not supported)
+  - Claude Code's `claude` CLI 2.1.282 or newer, for headless `claude-code:` rungs
+- Optional: a TypeSafe API key for Jev, in `TYPESAFE_API_KEY` or saved by `catherd init`
+
+`catherd doctor` checks each backend's version and login and prints the fix for anything missing. The default
+profile runs its workers on Codex; without Codex, doctor's fix also names how to move those roles to a backend
+you have (`/catherd-setup` in Claude Code, or `catherd profile set roles.<role>.rungs <rung>`).
 
 ## Install
 
@@ -34,15 +41,18 @@ of work, climbing a ladder only when a cheaper rung falls short.
 bunx catherd-cli init
 ```
 
-The npm package is `catherd-cli`; the command it installs is `catherd`. `init` asks for the Jev key, finds your backends, and builds your first profile. Then add the
-plugin to Claude Code:
+The npm package is `catherd-cli`; the command it installs is `catherd`. `init` asks for the optional Jev key,
+writes the default profile and links its Claude agents, lists your backends' models, and ends with a readiness
+report (`--no-input` asks nothing and keeps what exists; `--profile <name>` sets up and activates that profile
+instead of `default`; piped, it reads one answer per line once stdin closes: the Jev key, the profile, whether to replace it, each on its own line even when a question is skipped). Then add the plugin to Claude Code:
 
 ```sh
 claude plugin marketplace add 47vigen/catherd
 claude plugin install catherd@catherd
 ```
 
-Start a new Claude Code session so the plugin, its MCP server and the agent files load.
+Start a new Claude Code session so the plugin, its MCP server and the agent files load, then check with
+`bunx catherd-cli doctor`.
 
 ## Use
 
@@ -54,29 +64,103 @@ In Claude Code:
 
 In a terminal:
 
-| Command                            | What it does                                                     |
-| ---------------------------------- | ---------------------------------------------------------------- |
-| `bunx catherd-cli`                 | Profile editor: models and efforts per role, with paw checkboxes |
-| `bunx catherd-cli watch`           | Live view of running and recent runs                             |
-| `bunx catherd-cli lock -- <cmd>`   | Runs a heavy command behind the machine-wide semaphore           |
-| `bunx catherd-cli catalog refresh` | Refreshes the models.dev snapshot                                |
-
-`--plain` and `--reduced-motion` work everywhere.
+| Command                                                                                   | What it does                                                                             |
+| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `catherd`                                                                                 | The dashboard: Status, Profiles and Runs (below)                                         |
+| `catherd init [--no-input] [--profile <p>]`                                               | First-run setup                                                                          |
+| `catherd doctor [--json]`                                                                 | Readiness report, one row per check with its fix; exits 3 when not ready                 |
+| `catherd profile list\|show\|use [--repo]\|new [--from <p>]\|copy\|rm\|diff\|validate`    | Profiles; `use --repo` binds one to the repo you are in                                  |
+| `catherd profile use --repo --clear`                                                      | Unbinds the repo you are in; it runs on the active profile again                         |
+| `catherd profile set <path> <value> [--profile <p>]`                                      | One field, e.g. `roles.verifier.access read-only`, `budget.usd 20`                       |
+| `catherd status [run]`, `catherd watch [--once] [--interval <s>]`                         | Where runs stand                                                                         |
+| `catherd runs list [--repo <path>]\|show <id> [--debug [--name <n>]]\|cancel <id> <name>` | Past runs; `--debug` adds exit.json and the stderr and event tails, `--name` one role's  |
+| `catherd catalog refresh\|list [--backend <b>] [--role <r>] [--text <t>] [--scored]`      | The models catherd can place, filtered                                                   |
+| `catherd catalog treat-like <rung> <like>`                                                | Scores an unscored rung as a scored one                                                  |
+| `catherd lock [--slots N] -- <cmd>`                                                       | Runs a heavy command behind the machine-wide semaphore, in its own session (no /dev/tty) |
+| `catherd mcp`                                                                             | The MCP server on stdio; the plugin starts it, you never need to                         |
+| `catherd capture-fixtures [--backend <b>] [--out <dir>]`                                  | Contributors: records sanitized test fixtures from real runs (see CONTRIBUTING.md)       |
+
+A profile command without a profile name (`show`, `set`, `diff`, `validate`), like the MCP profile tools, acts
+on the profile the repo you are in runs on: the one bound to it, else the active one. Run them as
+`bunx catherd-cli <command>` when catherd is not installed globally. Every read command takes `--json`; a bare `catherd runs` is `catherd runs list`. Exit codes: 0 ok, 1 error, 2 usage, 3 not ready, 130 interrupted; an error prints
+`error E_CODE: message` and a `fix:` line. `--verbose` (or `CATHERD_LOG=debug`) logs more to
+`~/.local/share/catherd/logs/`, kept for 7 days with secrets redacted. The dashboard takes `--plain` (ASCII, no colour)
+and `--reduced-motion`; `doctor` and `init` take `--plain` for ASCII glyphs too. `NO_COLOR` drops colour, never glyphs.
 
 Run data lives in `~/.local/share/catherd/`, config in `~/.config/catherd/` (both follow
 `XDG_*`).
 
-## Develop
-
-```sh
-bun install
-bun test
-bun run typecheck && bun run lint && bun run format:check
-```
-
-Design: [`docs/specs/2026-09-24-catherd-design.md`](docs/specs/2026-09-24-catherd-design.md).
-Releases go through [Changesets](https://github.com/changesets/changesets): add one with
-`bunx changeset`.
+### Environment variables
+
+| Variable                    | What it does                                                                                          |
+| --------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `TYPESAFE_API_KEY`          | The Jev key, instead of the one `catherd init` saves                                                  |
+| `CATHERD_HOME`              | Puts config and data under `$CATHERD_HOME/config` and `$CATHERD_HOME/data` instead of XDG             |
+| `CATHERD_LOG`               | Log level: `off`, `error`, `warn`, `info` (default) or `debug` (what `--verbose` sets)                |
+| `CATHERD_LOCK_SLOTS`        | `catherd lock`'s slot count when `--slots` is not given (before the profile's `lock.heavy`)           |
+| `CATHERD_REDUCED_MOTION`    | Any value: the dashboard's `--reduced-motion`                                                         |
+| `CATHERD_NO_KITTY`          | Any value: turns off the kitty keyboard protocol in the dashboard, for terminals it breaks            |
+| `CATHERD_CLAUDE_AGENTS_DIR` | Where catherd links its Claude agents (default: `$CLAUDE_CONFIG_DIR/agents`, else `~/.claude/agents`) |
+| `NO_COLOR`                  | Drops colour (the dashboard's and `--help`'s; piped `--help` has none either)                         |
+
+For development only: `CATHERD_STORY=1` opens the dashboard's storybook, `CATHERD_TICK_MS` sets how often a blocked
+`wait` reports progress (default 30000), and `CATHERD_LIVE=1` enables the live tests
+(CONTRIBUTING.md has the rest).
+
+### The dashboard
+
+`catherd` opens three tabs: **1 Status** (every check with its fix; `y` copies the fix, `r` checks again),
+**2 Profiles** (one tree per profile: roles with their access, default rung, models and efforts, then routing,
+harness, budget, failover, timeouts and notify) and **3 Runs** (live roles, climbs, routes, the budget, landed
+milestones; `p` pauses). `catherd watch` opens it on Runs.
+
+- `ctrl+p` lists every command with its key and CLI twin; `?` lists the keys that work where you are.
+- `ctrl+x` is the leader: `ctrl+x 1`–`3` tabs, `ctrl+x n` new profile, `ctrl+x l` profiles, `ctrl+x u` and
+  `ctrl+x r` undo and redo, `ctrl+x q` quit.
+- Lists: arrows or `j`/`k`, `pgup`/`pgdn`, `home`/`g`, `end`/`G`, `/` to filter; `space` ticks, `enter`
+  changes or opens, `→`/`←` expand and collapse.
+- Edits are staged: nothing is written until `ctrl+s` shows the diff and you choose Save or Save & make active.
+  `enter` never saves.
+- Inside a repo bound to a profile, the dashboard opens on that profile, and making a profile active binds the
+  repo to it (as `catherd profile use <name> --repo`).
+- `esc` backs out one level and never quits. `q` quits, asking first if something is unsaved; `ctrl+c` quits
+  when nothing is, and pressed twice within 1.5 s discards and exits 130.
+- Deleting a profile or cancelling a live role takes `ctrl+d` twice.
+- `--plain` draws ASCII without colour, `NO_COLOR` drops the colour, `--reduced-motion` stops the spinner.
+- Rebind a key in `~/.config/catherd/config.json`: `"keybinds": { "profile.save": "ctrl+w", "app.help": "none" }`
+  (the palette shows each command by title; the ids are listed in
+  [`src/entry/tui/commands.ts`](src/entry/tui/commands.ts)).
+
+## Upgrading from 0.x
+
+1.0 is a clean break: run `bunx catherd-cli init` once. It moves your 0.x `config.json`, `projects.json` and
+profiles into a `0.x-backup-<time>/` folder next to them (it never reads or deletes them), writes the 1.0
+default profile, replaces the 0.x Claude agent links with 1.0 ones and keeps your saved Jev key; 0.x run
+folders stay where they are, unread. Then update the plugin
+(`claude plugin marketplace update catherd && claude plugin update catherd@catherd`) and start a new Claude
+Code session. The details are in [MIGRATION.md](MIGRATION.md).
+
+## Docs
+
+| Where                                                                                                                | What                                                                  |
+| -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [MIGRATION.md](MIGRATION.md)                                                                                         | Upgrading from 0.x                                                    |
+| [CHANGELOG.md](CHANGELOG.md)                                                                                         | Releases                                                              |
+| [CONTRIBUTING.md](CONTRIBUTING.md)                                                                                   | Development setup, the checks, commits, changesets, live tests        |
+| [SECURITY.md](SECURITY.md)                                                                                           | Reporting a vulnerability; what catherd stores and how                |
+| [`docs/superpowers/specs/2026-09-25-catherd-1.0-design.md`](docs/superpowers/specs/2026-09-25-catherd-1.0-design.md) | The 1.0 design (binding)                                              |
+| [`docs/dev/`](docs/dev/)                                                                                             | Maintainer docs: live verification, manual tests, dependencies, ideas |
+| [`docs/dev/live-verification.md`](docs/dev/live-verification.md)                                                     | What CI cannot run: live tests, fixture capture, the Codex sandbox    |
+| [`docs/tui-frames.md`](docs/tui-frames.md)                                                                           | Every dashboard screen as text (generated, checked in CI)             |
+| [`docs/superpowers/`](docs/superpowers/), [`docs/research/`](docs/research/)                                         | How 1.0 was designed and built: plans, reviews, research              |
+| [`docs/archive/0.x/`](docs/archive/0.x/)                                                                             | The 0.x design and plans, for history                                 |
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). CI runs the checks on Linux and macOS, on Bun 1.4.0 and the latest Bun;
+what CI cannot run is in [`docs/dev/live-verification.md`](docs/dev/live-verification.md). Report security issues
+privately, as [SECURITY.md](SECURITY.md) describes. Everyone taking part follows the
+[Code of Conduct](CODE_OF_CONDUCT.md).
 
 ## License
 

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,37 @@
+# Third-party notices
+
+catherd's TUI adapts code and designs from opencode (<https://github.com/anomalyco/opencode>), used under
+the MIT license below. Each derived file says so in its first lines:
+
+- `src/entry/tui/commands.ts`: command ids and default keys (`packages/tui/src/config/keybind.ts`)
+- `src/entry/tui/providers/keymap.tsx`: the keymap setup (`packages/tui/src/context/keymap.tsx`)
+- `src/entry/tui/providers/toast.tsx` and `src/entry/tui/widgets/toast.tsx`: toasts (`packages/tui/src/ui/toast.tsx`)
+- `src/entry/tui/widgets/dialog.tsx`: the dialog panel (`packages/tui/src/ui/dialog.tsx`)
+- `src/entry/tui/widgets/dialog-select.tsx`: the picker (`packages/tui/src/ui/dialog-select.tsx`)
+- `src/entry/tui/widgets/dialog-confirm.tsx`: confirmations (`packages/tui/src/ui/dialog-confirm.tsx`)
+- `src/entry/tui/widgets/dialog-prompt.tsx`: value editors (`packages/tui/src/ui/dialog-prompt.tsx`)
+- `src/entry/tui/widgets/spinner.tsx`: the spinner and its delayed presence (`packages/tui/src/component/spinner.tsx`, `startup-loading.tsx`)
+
+## opencode
+
+MIT License
+
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/catalog/jev.json

@@ -0,0 +1,89 @@
+{
+  "schema": 1,
+  "model": "jev-1.13.0",
+  "sets": {
+    "route-v2": {
+      "questions": {
+        "kind": {
+          "type": "choice",
+          "instructions": "What kind of work does the lane in the state describe?",
+          "criteria": {
+            "repo_code": "Code and tests inside an application or library repository",
+            "terminal": "Shell, build, CI, infrastructure or environment work, where the terminal is the main tool",
+            "ui": "User-interface work judged on screen: layout, styling, components",
+            "prose": "Writing that is not code: docs, a changelog, release notes, a merge request body",
+            "research": "Finding facts to answer a question, with no change to the product",
+            "other": "None of the above"
+          }
+        },
+        "difficulty": {
+          "type": "score",
+          "instructions": "Which situation matches the work the lane in the state asks for?",
+          "criteria": [
+            "A mechanical change: rename, move, delete or copy existing code, or change constants, with no new behaviour",
+            "New code that follows an existing example which the lane names or the repository already has",
+            "New logic with state, concurrency, data invariants or tricky edge cases",
+            "A cause nobody has found yet, a design across systems to settle, or no example to follow"
+          ]
+        },
+        "names_pattern": {
+          "type": "noul",
+          "instructions": "Does the lane in the state name an existing file, function, endpoint or test in the repository that the new work should copy or follow?",
+          "criteria": {
+            "true": "It names a concrete existing example by path or name",
+            "false": "It names no existing example, or only says to follow conventions in general"
+          }
+        },
+        "mechanical": {
+          "type": "noul",
+          "instructions": "Is the work in the lane in the state only mechanical: renaming, moving, deleting or copying code, or changing constants, with no new behaviour?"
+        },
+        "shared_state": {
+          "type": "noul",
+          "instructions": "Does the work in the lane in the state involve concurrency, caching, shared mutable state, transactions, or the ordering of events?"
+        },
+        "unclear_cause": {
+          "type": "noul",
+          "instructions": "Does the lane in the state ask the worker to find the cause of a bug or failure that the lane does not already explain?"
+        },
+        "open_design": {
+          "type": "noul",
+          "instructions": "Does the lane in the state leave an interface, data shape or algorithm for the worker to decide?"
+        },
+        "cross_boundary": {
+          "type": "noul",
+          "instructions": "Must the work in the lane in the state keep two or more services, processes or data stores consistent, such as a schema migration together with the code that reads it?"
+        },
+        "outside_repo": {
+          "type": "noul",
+          "instructions": "Does the work in the lane in the state depend on something outside the repository: a running service, credentials, network access, hardware or CI configuration?"
+        }
+      },
+      "rule": { "kindMin": 0.8, "trackMin": 0.8, "trackA": ["0", "1"], "trackB": ["2", "3"] }
+    },
+    "finding": {
+      "questions": {
+        "finding": {
+          "type": "choice",
+          "instructions": "A reviewer reported `finding` on the work planned in `lane`. Where is the defect?",
+          "criteria": {
+            "design": "The plan itself is wrong: its decisions, signatures or data shapes cannot meet the goal",
+            "code": "The plan is sound and the code does not implement it correctly",
+            "unclear": "The finding does not say enough to tell"
+          }
+        }
+      },
+      "rule": { "min": 0.83, "fallback": "code" }
+    },
+    "same-defect": {
+      "questions": {
+        "same-defect": {
+          "type": "choice",
+          "instructions": "Does `after` report the same underlying defect as `before`, even if worded differently or at another line?",
+          "criteria": { "yes": "Same underlying defect", "no": "A different defect" }
+        }
+      },
+      "rule": { "min": 0.85, "fallback": "no" }
+    }
+  }
+}

package/catalog/models.json

@@ -0,0 +1,236 @@
+{
+  "schema": 1,
+  "version": "2026-09-25",
+  "sources": {
+    "claude": "https://platform.claude.com/docs/en/models/overview (2026-09-25); efforts https://platform.claude.com/docs/en/build-with-claude/effort; prices https://platform.claude.com/docs/en/about-claude/pricing",
+    "codex": "codex debug models --bundled, Codex CLI 0.157.0 (2026-09-25); prices https://developers.openai.com/api/docs/pricing; plan weights https://learn.chatgpt.com/docs/pricing",
+    "opencode": "opencode models <provider> --verbose on 1.18.32 and the v2 model.list (2026-09-25); https://opencode.ai/docs/zen, https://opencode.ai/docs/go"
+  },
+  "backends": {
+    "codex": {
+      "imageGen": {
+        "tool": "gpt-image-2",
+        "requires": "chatgpt-login",
+        "source": "https://learn.chatgpt.com/docs/image-generation"
+      }
+    }
+  },
+  "families": [
+    {
+      "id": "gpt-6-astra",
+      "name": "GPT-6 Astra",
+      "vendor": "openai",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 10, "cached": 1, "output": 50 },
+      "planWeight": 60,
+      "on": {
+        "codex": {
+          "id": "gpt-6-astra",
+          "efforts": ["low", "medium", "high", "xhigh", "max", "ultra"],
+          "context": 272000
+        },
+        "opencode": {
+          "id": "opencode/gpt-6-astra",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        }
+      },
+      "notes": {
+        "ultra": "maximum reasoning with automatic task delegation to parallel subagents; never in a default ladder"
+      }
+    },
+    {
+      "id": "gpt-6-sol",
+      "name": "GPT-6 Sol",
+      "vendor": "openai",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 2, "cached": 0.2, "output": 10 },
+      "planWeight": 20,
+      "on": {
+        "codex": {
+          "id": "gpt-6-sol",
+          "efforts": ["low", "medium", "high", "xhigh", "max", "ultra"],
+          "context": 272000
+        },
+        "opencode": {
+          "id": "opencode/gpt-6-sol",
+          "efforts": ["none", "low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        }
+      },
+      "notes": {
+        "ultra": "maximum reasoning with automatic task delegation to parallel subagents; never in a default ladder"
+      }
+    },
+    {
+      "id": "gpt-6-luna",
+      "name": "GPT-6 Luna",
+      "vendor": "openai",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 0.1, "cached": 0.01, "output": 0.5 },
+      "planWeight": 1,
+      "on": {
+        "codex": {
+          "id": "gpt-6-luna",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 272000
+        },
+        "opencode": {
+          "id": "opencode/gpt-6-luna",
+          "efforts": ["none", "low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        },
+        "opencode-go": {
+          "id": "opencode-go/gpt-6-luna",
+          "efforts": ["none", "low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        }
+      }
+    },
+    {
+      "id": "gpt-5.6-sol",
+      "name": "GPT-5.6 Sol",
+      "vendor": "openai",
+      "status": "legacy",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 4, "cached": 0.4, "output": 20 },
+      "planWeight": 30,
+      "on": {
+        "codex": {
+          "id": "gpt-5.6-sol",
+          "efforts": ["low", "medium", "high", "xhigh", "max", "ultra"],
+          "context": 272000
+        },
+        "opencode": {
+          "id": "opencode/gpt-5.6-sol",
+          "efforts": ["none", "low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        }
+      },
+      "notes": { "upgrade": "Codex offers gpt-6-sol as its upgrade" }
+    },
+    {
+      "id": "gpt-5.6-terra",
+      "name": "GPT-5.6 Terra",
+      "vendor": "openai",
+      "status": "legacy",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 2, "cached": 0.2, "output": 12 },
+      "planWeight": 15,
+      "on": {
+        "codex": {
+          "id": "gpt-5.6-terra",
+          "efforts": ["low", "medium", "high", "xhigh", "max", "ultra"],
+          "context": 272000
+        },
+        "opencode": {
+          "id": "opencode/gpt-5.6-terra",
+          "efforts": ["none", "low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        }
+      },
+      "notes": { "upgrade": "Codex offers gpt-6-sol as its upgrade" }
+    },
+    {
+      "id": "gpt-5.6-luna",
+      "name": "GPT-5.6 Luna",
+      "vendor": "openai",
+      "status": "legacy",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 0.2, "cached": 0.02, "output": 1.2 },
+      "planWeight": 1.5,
+      "on": {
+        "codex": {
+          "id": "gpt-5.6-luna",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 272000
+        },
+        "opencode": {
+          "id": "opencode/gpt-5.6-luna",
+          "efforts": ["none", "low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        },
+        "opencode-go": {
+          "id": "opencode-go/gpt-5.6-luna",
+          "efforts": ["none", "low", "medium", "high", "xhigh", "max"],
+          "context": 1050000
+        }
+      },
+      "notes": { "upgrade": "Codex offers gpt-6-luna as its upgrade" }
+    },
+    {
+      "id": "claude-fable-5-1",
+      "name": "Claude Fable 5.1",
+      "vendor": "anthropic",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 10, "cached": 0.25, "output": 50 },
+      "meteredOnPlan": true,
+      "on": {
+        "claude-code": {
+          "id": "claude-fable-5-1",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 1000000
+        },
+        "opencode": {
+          "id": "opencode/claude-fable-5-1",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 1000000
+        }
+      },
+      "notes": {
+        "plan": "Pro and Team Standard pay usage credits for Fable; Max includes it up to half the weekly limit"
+      }
+    },
+    {
+      "id": "claude-opus-5-5",
+      "name": "Claude Opus 5.5",
+      "vendor": "anthropic",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 4, "cached": 0.2, "output": 20 },
+      "on": {
+        "claude-code": {
+          "id": "claude-opus-5-5",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 1000000
+        },
+        "opencode": {
+          "id": "opencode/claude-opus-5-5",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 1000000
+        }
+      },
+      "notes": { "effort": "the API default effort is medium" }
+    },
+    {
+      "id": "claude-sonnet-5",
+      "name": "Claude Sonnet 5",
+      "vendor": "anthropic",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 2, "cached": 0.2, "output": 10 },
+      "on": {
+        "claude-code": {
+          "id": "claude-sonnet-5",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 1000000
+        },
+        "opencode": {
+          "id": "opencode/claude-sonnet-5",
+          "efforts": ["low", "medium", "high", "xhigh", "max"],
+          "context": 1000000
+        }
+      }
+    },
+    {
+      "id": "claude-haiku-4-5",
+      "name": "Claude Haiku 4.5",
+      "vendor": "anthropic",
+      "capabilities": { "toolUse": true, "imageIn": true, "reasoning": true },
+      "price": { "input": 1, "cached": 0.1, "output": 5 },
+      "on": {
+        "claude-code": { "id": "claude-haiku-4-5-20251001", "efforts": [], "context": 200000 },
+        "opencode": { "id": "opencode/claude-haiku-4-5", "efforts": ["high", "max"], "context": 200000 }
+      },
+      "notes": { "effort": "no effort parameter in Claude Code: its only rung there is #default" }
+    }
+  ]
+}