AI agnostic: where the forge names or assumes one vendor
The forge is meant to connect whichever AI a person brings. Claude has been
the first and is still recommended, so it may head a list a person picks from;
it is not what the forge is built around. This is the inventory (#12121, from
the owner's ask #12068): every place under src/, scripts/ and the docs that
names or assumes one vendor, so each can be removed by the issue named beside
it. It changes no code.
Marks:
- seam: code that is one vendor's CLI, protocol or credential format and
would have to be written again for another AI. It moves behind the agent
runner (src/crew/agent_runner.ts); the vendor's implementation stays, as
the first runner.
- word: a name a person reads (page, terminal, log, error, setting, doc,
env name). It becomes "your AI", "model" or "runner"; a vendor's name stays only where a person picks one.
- tuning: a number, alias, ladder or prompt chosen for one model family's
habits (aliases, prices, limits, session files).
Removing issues: #12122 the runner seam (the CLI stays the first runner), #12123 usage and limits through the seam, #12124 the OpenAI-compatible second runner, #12125 the real-cell hello-app test with it, #12126 pages and terminal words, #12127 neutral env names and log lines (old names still read), #12128 briefs and prompts with nothing for one model family. "Stays" means a person picks it there, so the name is right; the row is listed so nothing is forgotten.
Symbols are given where a line number would drift; grep -n the symbol.
Code seams
| File | Line or symbol | Mark | What it assumes | Removed by | |||
|---|---|---|---|---|---|---|---|
src/crew/claude.ts | runClaude, claudeArgs, claudeSettings, detectClaude | seam | claude -p stream-json, its flags, its settings JSON, its result and rate_limit_event records | #12122 (becomes the first runner; stays) | |||
src/crew/agent_runner.ts | claude runner object, import of ./claude.ts | seam | the only registered runner is Claude's | #12124 adds the second | |||
src/crew/runner.ts | spawn env: CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR, TMPDIR pairing (~1480-1515) | seam | the CLI's config and temp variables are set by the crew loop | #12122 | |||
src/crew/runner.ts | credential variable list: ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN (~2411-2426, ~1463) | seam | which env carries a credential into a run | #12122, #12127 | |||
src/crew/one_shot.ts | env with CLAUDE_CONFIG_DIR | seam | one-shot calls use the CLI's config directory | #12122 | |||
src/crew/conversation.ts | sessionsDir (claude-config), CLAUDE_CONFIG_DIR, resume refusal text, claudeSessionId use | seam | a conversation resumes a CLI session file | #12122 | |||
src/core/conversations.ts | claudeSessionId, claude_session_id, setClaudeSession | seam | the conversation row stores the CLI's session id (a column name; a rename needs a migration) | #12122 | |||
src/core/migrations/20261101090000-conversation.ts, 20261103120000-conversations-many.ts | claude_session_id column | seam | the same column; migrations are pinned and stay as written | #12122 (a new migration renames it) | |||
src/crew/plan.ts | PLAN_MODEL = "haiku", CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, planningAvailable runs claude | seam | the planner's one-shot call is the CLI | #12122, #12127 | |||
src/crew/sandbox.ts | .claude, .claude.json denials, claude-<uid> temp dir, CLAUDE_CODE_TMPDIR, socket-name limits | seam | the sandbox policy is written for the CLI's bridge sockets and files | #12122 | |||
src/crew/leftovers.ts | sweep of the CLI's sandbox bridges | seam | cleans processes only that CLI leaves | #12122 | |||
src/crew/network.ts | transient network error handling "Claude Code ends such a run…" | seam | which errors the CLI reports and how | #12123 | |||
src/crew/grant.ts | env filter `^(FORGE_\ | GIT_\ | CLAUDE_\ | ANTHROPIC_…` | seam | which names are stripped from an agent's environment | #12127 |
src/crew/dispatch.ts | detected.version, claude not usable, Claude Code ${version} (health detail) | seam, word | startup check is for the CLI | #12122 (check), #12127 (words) | |||
src/main.ts | FORGE_CLAUDE (lines 586, 604), FORGE_CLAUDE_CONFIG_DIR (lines 594-596, 608), comment on the CLI's bridges | seam | the binary and config directory come from vendor-named env | #12127 | |||
src/actions/apps.ts | process.env["FORGE_CLAUDE"] ?? "claude" | seam | planning looks for the CLI | #12127 | |||
src/web/pages/apps.ts | planningAvailable(FORGE_CLAUDE ?? "claude") | seam | same, on the page | #12127 | |||
src/spawn/cell.ts | claude? input, FORGE_CLAUDE passed to a child forge | seam | a hosted forge's crew binary | #12127 | |||
src/spawn/funding.ts | ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY for a child | seam | a child's starter key is an Anthropic-shaped credential | #12122, #12127 | |||
src/spawn/model_door.ts | ANTHROPIC_*, CLAUDE_CODE_OAUTH_TOKEN, anthropic-version, anthropic-beta headers, api.anthropic.com default | seam | the model door proxies one vendor's wire protocol | #12124 (a second protocol beside it) | |||
src/spawn/door.ts | credential help text: "Anthropic key, claude setup-token", the sk-ant-oat rule | seam, word | validation of one vendor's token shapes | #12126 (words), #12124 | |||
src/core/subscriptions.ts | tokenEnvName (CLAUDE_CODE_OAUTH_TOKEN / ANTHROPIC_API_KEY), ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN dance, sk-ant-oat and sk-ant-api detection, "Anthropic-compatible base URL", env presence check (~749) | seam | an account is one vendor's credential kind | #12122, #12124, #12127 | |||
src/core/subscriptions_words.ts | claude setup-token, sk-ant-oat, OpenRouter note | word | help text for one vendor's token | #12126 | |||
src/core/migrations/0026-subscriptions.ts, 0071-an-optional-anthropic-compatible-api.ts (+ pin in migration-pins.json) | table and column history | word | historic migrations; pinned, never edited | #12122 (a new migration renames the column); these stay | |||
src/core/capacity.ts | kind values off / openrouter / anthropic / both, hosts api.anthropic.com:443, comments | seam, word | a child forge's allowed model hosts name two vendors | #12127, #12126 | |||
src/apps/egress.ts | comment: a crew's Claude Code reaches nothing | word | comment only | #12127 | |||
src/apps/process.ts | comments: the CLI's login, keychain | word | comment only | #12127 | |||
src/core/plugin_install.ts | claudeInstall, claudeMarketplace, claude plugin marketplace add | seam | the Claude Code plugin install flow | #12126 (stays: a person picks Claude Code; listed beside opencodeInstall) | |||
src/core/mcp_card.ts | harness claude-code / "Claude Code" | word | the harness list | #12126 (stays: kept as one picker choice) | |||
src/http/plugin_routes.ts | /plugins/claude-code/marketplace.json, plugins/claude-code/commands | seam | route and path of the Claude Code plugin | #12126 (stays: one picker choice) | |||
plugins/claude-code/, plugins/opencode/ | plugin directories | seam | one plugin per harness | #12126 (stays: one picker choice each) | |||
scripts/cold-read.ts | ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, x-api-key / anthropic-version, default claude-sonnet-5-5 | seam | the cold-read audit calls one vendor's API | #12124 | |||
src/crew/first_look.ts | FIRST_LOOK_MODEL = "claude-sonnet-5-5" | tuning | a fixed model id | #12122 |
Usage, limits and prices
| File | Line or symbol | Mark | What it assumes | Removed by |
|---|---|---|---|---|
src/core/measure.ts | header, rate_limit_event parser | seam | the usage meter reads the CLI's rate-limit event format | #12123 |
src/core/standing.ts | comments: "Claude Code's refusal names the window", 5 h / 7 d windows | tuning | windows of one vendor's subscription | #12123 |
src/crew/limits.ts | refusal text, api_error, resets 7:20am (UTC) parser | seam | the CLI's wording of a limit | #12123 |
src/core/usage.ts | comment: cache reads "as Claude Code's result.usage reports them" | seam | the token fields | #12123 |
src/crew/claude.ts | total_cost_usd, error_max_budget handling | seam | cost and budget endings by the CLI's names | #12123 |
src/crew/agent_runner.ts | comments on total_cost_usd, "Claude: five minutes", "five seconds" | tuning | defaults named for the CLI | #12123 |
src/spawn/list_price.ts | table of Opus / Sonnet / Haiku prices from anthropic.com | tuning | list prices known for one family | #12123 (the runner reports cost; the table is a fallback) |
src/kernel/tokens-format.ts | "Claude's tokenizer" in tooltips (counted, estimate) and the ratio note on Anthropic and OpenAI | word | wording of the estimate | #12126 |
src/actions/spend.ts, src/web/pages/spend.ts | "as Claude Code reports them" | word | spend page caption | #12126 |
Models and their tuning
| File | Line or symbol | Mark | What it assumes | Removed by |
|---|---|---|---|---|
src/crew/models.ts | list: claude-fable-5-1, opus, sonnet, haiku | tuning | the picker's choices (the recommended one stays first) | #12126 (a picker, per runner) |
src/crew/model_choice.ts | OPUS_MODEL, OPUS_LABEL = "opus", PLANNER_MODEL = "sonnet", reasons label:opus, planner:handed | tuning | escalation is to a named model | #12122, #12126 (a "stronger model" tier per runner) |
src/core/model_review.ts | LADDER = ["claude-fable-5-1","opus","sonnet","haiku"], SQL on label:opus | tuning | the review ladder | #12122 |
src/core/agents.ts | "A Claude Code model alias or id" | word | model field comment | #12126 |
src/core/runs.ts | comment: "what escalated the run to Opus" | word | comment | #12126 |
src/core/migrations/20261027140000-run-model-reason.ts, 20261109190000-run-context-tokens.ts | comments | word | pinned history | #12126 (stays: pinned, never edited) |
src/crew/runner.ts | comments on Opus / Sonnet choice (~1527) | word | comment | #12126 |
Prompts and briefs
| File | Line or symbol | Mark | What it assumes | Removed by | |
|---|---|---|---|---|---|
src/crew/brief.ts | system prompt "appended to Claude…", "the repository's CLAUDE.md or AGENTS.md" | tuning | text for one CLI and its memory file | #12128 | |
src/crew/claude.ts | claudeSettings tools and permissions | tuning | tool names only that CLI knows | #12128 (lives with its runner) | |
src/crew/conversation.ts, src/crew/conversation_confirm.ts | "add a Claude login", MCP-only settings via claudeSettings | tuning, word | conversation tools in the CLI's shape | #12128, #12126 | |
src/web/doors_words.ts | "Read README.md and CLAUDE.md (when present)" | tuning | a prompt handed to any assistant names one memory file | #12128 | |
src/web/standards.ts | "Claude Code plugin: not offered…", "its crew needs the claude CLI" | word | standards and install text | #12126 | |
CLAUDE.md (repository root) | the project's own instructions file; AGENTS.md is the neutral twin | tuning | the file name the CLI reads | #12128 (point both at one text) | |
src/crew/dispatch.ts, src/crew/runner.ts | log lines claude: budget $…, claude: <reason>, N turns, claude: wrapping up with the reserve; crew is up with claude: <version>; claude not usable | word | log lines other tools and src/web/pages/runs.ts / src/web/client.ts match on `^(claude:\ | done:…` | #12127 (log), then the two matchers in the same change |
Pages, settings and the terminal
| File | Line or symbol | Mark | What it assumes | Removed by | |
|---|---|---|---|---|---|
src/web/pages/model.ts | page "Model", claude setup-token hint | word | should read "Connect your AI" | #12126 | |
src/tui/screens/model.ts | "token (from claude setup-token…)", "API base URL (empty for Anthropic)" | word | same, in the terminal | #12126 | |
src/web/pages/subscriptions.ts, src/tui/screens/subscriptions.ts, grants.ts, orggrants.ts | "Claude subscription", "Add a Claude account", claude setup-token, "Empty for Anthropic itself" | word | the accounts page | #12126 | |
src/http/mcp/tools/subscriptions.ts, subscription_add.ts, subscription_wake.ts | "Claude accounts", "Add a Claude login" | word | MCP tool descriptions | #12126 | |
src/actions/talk.ts, src/contract/openapi/routes/postApiV1ConversationMessages.ts, getApiV1AdminSubscriptions.ts | "no Claude account is granted…" | word | error and API text (contract text, regenerate) | #12126 | |
src/web/studio/crew_key.ts, src/tui/screens/crewkey.ts | "Your Anthropic API key or Claude login" | word | the first-run key form | #12126 | |
src/web/pages/crew.ts | "Claude Code on PATH or at FORGE_CLAUDE" | word, seam | operator hint | #12126, #12127 | |
src/web/pages/new-forge.ts, src/tui/screens/newforge.ts | "Anthropic-compatible gateway", "Leave empty for Anthropic", "a Claude sign-in key (sk-ant-oat…)" | word | hosted-forge form | #12126 | |
src/actions/spawn.ts | comment on the Anthropic-compatible base URL | word | comment | #12127 | |
src/packs/up.ts | "start this command again with ANTHROPIC_API_KEY set" | word, seam | CLI message | #12127 | |
src/web/pages/account.ts | connect-claude, "Claude Code" plugin card, claudeInstall | word | connect-a-harness card | #12126 (stays: one entry in a picker list) | |
src/tui/screens/signins.ts | "Claude Code plugin (c copies)", claudeInstall | word | terminal sign-in screen | #12126 (stays: one picker choice) | |
src/tui/screens/changelog.ts | "by Scout, with Claude Sonnet 5.5" | word | an example of the co-author line | #12126 (stays: the commit's own words) | |
src/web/studio/home.ts | "Open in ChatGPT, Claude and Grok" links, claude.ai/new | word | a list of assistants, one per vendor, already plural | #12126 (stays: a person picks one) | |
src/http/mcp.ts | header: "Added to Claude as a connector…" | word | comment | #12126 | |
src/core/contribute_token.ts | comment listing Codex, Jules, Claude Code, Cursor | word | already plural | #12126 (stays: a list of harnesses) | |
src/web/pages/runs.ts, src/web/client.ts | line matcher `^(claude:\ | done:…` | word | recognises the CLI's log prefix | #12127 |
src/core/migrations/0061-an-agent-never-owns-an.ts | line 1: "CLAUDE.md invariant 10" | word | comment naming the repo's rules file; pinned in migration-pins.json | #12128 (stays as written: pinned) | |
src/actions/orgs.ts, src/core/orgs.ts | "CLAUDE.md, invariant 10" in comments | word | names the repo's own rules file | #12128 |
Docs
These name the CLI as how the crew runs today; each follows the code change that makes it true. "Line" is the first match; the count is every match.
| File | Line (matches) | Mark | What it names | Removed by |
|---|---|---|---|---|
docs/CREW.md | 8 (11) | word | the crew "runs Claude Code"; env names | #12126, #12127 |
docs/APPS.md | 317 (16) | word | the claude one-shot call, FORGE_CLAUDE | #12127 |
docs/MCP.md | 210 (15) | word | "Add a Claude login", tool descriptions | #12126 |
docs/REFERENCE.md | 62 (9) | word | opus-labelled escalation, the CLI | #12126, #12127 |
docs/ARCHITECTURE.md | 645 (3) | word | a Claude Code session in the clone | #12126 |
docs/CACHING.md | 35 (2) | word | "CLAUDE.md, invariant 4": the rules file | #12128 |
docs/features/tokens-harness.md | 4 (5) | word | harness names | #12126 (stays where a person picks one) |
docs/features/child-credit.md | 26 (6) | word | ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL | #12127 |
docs/features/talk.md | 9 (2) | word | "a granted Claude account" | #12126 |
docs/features/talk-captain.md | 3 (2) | word | Claude account, session | #12126 |
docs/features/starter-crew.md | 5 (1) | word | bring your own key, one vendor's | #12126 |
docs/features/real-cell-proof.md | 8 (1) | word | FORGE_CLAUDE in a cell | #12125, #12127 |
docs/features/contribute-token.md | 3 (1) | word | list of agents incl. Claude Code | #12126 (stays: a list) |
docs/features/nightly.md | 28 (1) | word | the crew's Claude credential | #12127 |
docs/features/changelog.md | 25 (1) | word | co-author line example | #12126 (stays: commit's own words) |
docs/features/first_look.md | 5 (1) | tuning | a fixed model id | #12122 |
docs/features/model-escalation.md | 1 (5) | tuning | escalate to Opus | #12122, #12126 |
docs/features/model-review.md | 3 (2) | tuning | the review ladder | #12122 |
docs/DEVELOP.md | 18 (1) | word | cold-read.ts and its key | #12124 |
docs/EXTRACT.md | 11 (2) | word | the claude binary | #12127 |
docs/ON-YOUR-MACHINE.md | 129 (1) | word | the CLI's login | #12126 |
docs/STATUS.md | 139 (1) | word | "in the background with Claude Code" | #12126 |
docs/VISION.md | 10 (1) | word | harness list | #12126 (stays: a list) |
docs/design/audit.md | 81 (1) | word | a page's wording | #12126 |
docs/ops/RED-TEAM.md | 23 (2) | seam | claudeSettings sandbox | #12122 |
docs/research/celld.md | 44 (1) | word | the CLI's bubblewrap policy | #12122 |
README.md | 33 (1) | word | "needs the claude CLI" | #12126, #12127 |
CLAUDE.md | 1 (4) | tuning | the file name the CLI reads | #12128 |
How to keep this true
grep -rniE "claude|anthropic|opus|sonnet|haiku" src scripts is the check
this list was built from (318 matching lines in 86 files under src and
scripts on the day it was written; the counts above drift, the grep is the truth). When #12126 lands, the same grep over src/web and src/tui
should find only a picker's choices; a row that no longer matches is deleted
from this file in the pull that removed it.