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:

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.

env name). It becomes "your AI", "model" or "runner"; a vendor's name stays only where a person picks one.

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

FileLine or symbolMarkWhat it assumesRemoved by
src/crew/claude.tsrunClaude, claudeArgs, claudeSettings, detectClaudeseamclaude -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.tsclaude runner object, import of ./claude.tsseamthe only registered runner is Claude's#12124 adds the second
src/crew/runner.tsspawn env: CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR, TMPDIR pairing (~1480-1515)seamthe CLI's config and temp variables are set by the crew loop#12122
src/crew/runner.tscredential variable list: ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN (~2411-2426, ~1463)seamwhich env carries a credential into a run#12122, #12127
src/crew/one_shot.tsenv with CLAUDE_CONFIG_DIRseamone-shot calls use the CLI's config directory#12122
src/crew/conversation.tssessionsDir (claude-config), CLAUDE_CONFIG_DIR, resume refusal text, claudeSessionId useseama conversation resumes a CLI session file#12122
src/core/conversations.tsclaudeSessionId, claude_session_id, setClaudeSessionseamthe 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.tsclaude_session_id columnseamthe same column; migrations are pinned and stay as written#12122 (a new migration renames it)
src/crew/plan.tsPLAN_MODEL = "haiku", CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, planningAvailable runs claudeseamthe 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 limitsseamthe sandbox policy is written for the CLI's bridge sockets and files#12122
src/crew/leftovers.tssweep of the CLI's sandbox bridgesseamcleans processes only that CLI leaves#12122
src/crew/network.tstransient network error handling "Claude Code ends such a run…"seamwhich errors the CLI reports and how#12123
src/crew/grant.tsenv filter `^(FORGE_\GIT_\CLAUDE_\ANTHROPIC_…`seamwhich names are stripped from an agent's environment#12127
src/crew/dispatch.tsdetected.version, claude not usable, Claude Code ${version} (health detail)seam, wordstartup check is for the CLI#12122 (check), #12127 (words)
src/main.tsFORGE_CLAUDE (lines 586, 604), FORGE_CLAUDE_CONFIG_DIR (lines 594-596, 608), comment on the CLI's bridgesseamthe binary and config directory come from vendor-named env#12127
src/actions/apps.tsprocess.env["FORGE_CLAUDE"] ?? "claude"seamplanning looks for the CLI#12127
src/web/pages/apps.tsplanningAvailable(FORGE_CLAUDE ?? "claude")seamsame, on the page#12127
src/spawn/cell.tsclaude? input, FORGE_CLAUDE passed to a child forgeseama hosted forge's crew binary#12127
src/spawn/funding.tsANTHROPIC_BASE_URL, ANTHROPIC_API_KEY for a childseama child's starter key is an Anthropic-shaped credential#12122, #12127
src/spawn/model_door.tsANTHROPIC_*, CLAUDE_CODE_OAUTH_TOKEN, anthropic-version, anthropic-beta headers, api.anthropic.com defaultseamthe model door proxies one vendor's wire protocol#12124 (a second protocol beside it)
src/spawn/door.tscredential help text: "Anthropic key, claude setup-token", the sk-ant-oat ruleseam, wordvalidation of one vendor's token shapes#12126 (words), #12124
src/core/subscriptions.tstokenEnvName (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)seaman account is one vendor's credential kind#12122, #12124, #12127
src/core/subscriptions_words.tsclaude setup-token, sk-ant-oat, OpenRouter notewordhelp 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 historywordhistoric migrations; pinned, never edited#12122 (a new migration renames the column); these stay
src/core/capacity.tskind values off / openrouter / anthropic / both, hosts api.anthropic.com:443, commentsseam, worda child forge's allowed model hosts name two vendors#12127, #12126
src/apps/egress.tscomment: a crew's Claude Code reaches nothingwordcomment only#12127
src/apps/process.tscomments: the CLI's login, keychainwordcomment only#12127
src/core/plugin_install.tsclaudeInstall, claudeMarketplace, claude plugin marketplace addseamthe Claude Code plugin install flow#12126 (stays: a person picks Claude Code; listed beside opencodeInstall)
src/core/mcp_card.tsharness claude-code / "Claude Code"wordthe harness list#12126 (stays: kept as one picker choice)
src/http/plugin_routes.ts/plugins/claude-code/marketplace.json, plugins/claude-code/commandsseamroute and path of the Claude Code plugin#12126 (stays: one picker choice)
plugins/claude-code/, plugins/opencode/plugin directoriesseamone plugin per harness#12126 (stays: one picker choice each)
scripts/cold-read.tsANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, x-api-key / anthropic-version, default claude-sonnet-5-5seamthe cold-read audit calls one vendor's API#12124
src/crew/first_look.tsFIRST_LOOK_MODEL = "claude-sonnet-5-5"tuninga fixed model id#12122

Usage, limits and prices

FileLine or symbolMarkWhat it assumesRemoved by
src/core/measure.tsheader, rate_limit_event parserseamthe usage meter reads the CLI's rate-limit event format#12123
src/core/standing.tscomments: "Claude Code's refusal names the window", 5 h / 7 d windowstuningwindows of one vendor's subscription#12123
src/crew/limits.tsrefusal text, api_error, resets 7:20am (UTC) parserseamthe CLI's wording of a limit#12123
src/core/usage.tscomment: cache reads "as Claude Code's result.usage reports them"seamthe token fields#12123
src/crew/claude.tstotal_cost_usd, error_max_budget handlingseamcost and budget endings by the CLI's names#12123
src/crew/agent_runner.tscomments on total_cost_usd, "Claude: five minutes", "five seconds"tuningdefaults named for the CLI#12123
src/spawn/list_price.tstable of Opus / Sonnet / Haiku prices from anthropic.comtuninglist 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 OpenAIwordwording of the estimate#12126
src/actions/spend.ts, src/web/pages/spend.ts"as Claude Code reports them"wordspend page caption#12126

Models and their tuning

FileLine or symbolMarkWhat it assumesRemoved by
src/crew/models.tslist: claude-fable-5-1, opus, sonnet, haikutuningthe picker's choices (the recommended one stays first)#12126 (a picker, per runner)
src/crew/model_choice.tsOPUS_MODEL, OPUS_LABEL = "opus", PLANNER_MODEL = "sonnet", reasons label:opus, planner:handedtuningescalation is to a named model#12122, #12126 (a "stronger model" tier per runner)
src/core/model_review.tsLADDER = ["claude-fable-5-1","opus","sonnet","haiku"], SQL on label:opustuningthe review ladder#12122
src/core/agents.ts"A Claude Code model alias or id"wordmodel field comment#12126
src/core/runs.tscomment: "what escalated the run to Opus"wordcomment#12126
src/core/migrations/20261027140000-run-model-reason.ts, 20261109190000-run-context-tokens.tscommentswordpinned history#12126 (stays: pinned, never edited)
src/crew/runner.tscomments on Opus / Sonnet choice (~1527)wordcomment#12126

Prompts and briefs

FileLine or symbolMarkWhat it assumesRemoved by
src/crew/brief.tssystem prompt "appended to Claude…", "the repository's CLAUDE.md or AGENTS.md"tuningtext for one CLI and its memory file#12128
src/crew/claude.tsclaudeSettings tools and permissionstuningtool 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 claudeSettingstuning, wordconversation tools in the CLI's shape#12128, #12126
src/web/doors_words.ts"Read README.md and CLAUDE.md (when present)"tuninga 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"wordstandards and install text#12126
CLAUDE.md (repository root)the project's own instructions file; AGENTS.md is the neutral twintuningthe file name the CLI reads#12128 (point both at one text)
src/crew/dispatch.ts, src/crew/runner.tslog lines claude: budget $…, claude: <reason>, N turns, claude: wrapping up with the reserve; crew is up with claude: <version>; claude not usablewordlog 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

FileLine or symbolMarkWhat it assumesRemoved by
src/web/pages/model.tspage "Model", claude setup-token hintwordshould read "Connect your AI"#12126
src/tui/screens/model.ts"token (from claude setup-token…)", "API base URL (empty for Anthropic)"wordsame, 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"wordthe accounts page#12126
src/http/mcp/tools/subscriptions.ts, subscription_add.ts, subscription_wake.ts"Claude accounts", "Add a Claude login"wordMCP tool descriptions#12126
src/actions/talk.ts, src/contract/openapi/routes/postApiV1ConversationMessages.ts, getApiV1AdminSubscriptions.ts"no Claude account is granted…"worderror 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"wordthe first-run key form#12126
src/web/pages/crew.ts"Claude Code on PATH or at FORGE_CLAUDE"word, seamoperator 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…)"wordhosted-forge form#12126
src/actions/spawn.tscomment on the Anthropic-compatible base URLwordcomment#12127
src/packs/up.ts"start this command again with ANTHROPIC_API_KEY set"word, seamCLI message#12127
src/web/pages/account.tsconnect-claude, "Claude Code" plugin card, claudeInstallwordconnect-a-harness card#12126 (stays: one entry in a picker list)
src/tui/screens/signins.ts"Claude Code plugin (c copies)", claudeInstallwordterminal sign-in screen#12126 (stays: one picker choice)
src/tui/screens/changelog.ts"by Scout, with Claude Sonnet 5.5"wordan 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/newworda list of assistants, one per vendor, already plural#12126 (stays: a person picks one)
src/http/mcp.tsheader: "Added to Claude as a connector…"wordcomment#12126
src/core/contribute_token.tscomment listing Codex, Jules, Claude Code, Cursorwordalready plural#12126 (stays: a list of harnesses)
src/web/pages/runs.ts, src/web/client.tsline matcher `^(claude:\done:…`wordrecognises the CLI's log prefix#12127
src/core/migrations/0061-an-agent-never-owns-an.tsline 1: "CLAUDE.md invariant 10"wordcomment 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 commentswordnames 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.

FileLine (matches)MarkWhat it namesRemoved by
docs/CREW.md8 (11)wordthe crew "runs Claude Code"; env names#12126, #12127
docs/APPS.md317 (16)wordthe claude one-shot call, FORGE_CLAUDE#12127
docs/MCP.md210 (15)word"Add a Claude login", tool descriptions#12126
docs/REFERENCE.md62 (9)wordopus-labelled escalation, the CLI#12126, #12127
docs/ARCHITECTURE.md645 (3)worda Claude Code session in the clone#12126
docs/CACHING.md35 (2)word"CLAUDE.md, invariant 4": the rules file#12128
docs/features/tokens-harness.md4 (5)wordharness names#12126 (stays where a person picks one)
docs/features/child-credit.md26 (6)wordANTHROPIC_API_KEY, ANTHROPIC_BASE_URL#12127
docs/features/talk.md9 (2)word"a granted Claude account"#12126
docs/features/talk-captain.md3 (2)wordClaude account, session#12126
docs/features/starter-crew.md5 (1)wordbring your own key, one vendor's#12126
docs/features/real-cell-proof.md8 (1)wordFORGE_CLAUDE in a cell#12125, #12127
docs/features/contribute-token.md3 (1)wordlist of agents incl. Claude Code#12126 (stays: a list)
docs/features/nightly.md28 (1)wordthe crew's Claude credential#12127
docs/features/changelog.md25 (1)wordco-author line example#12126 (stays: commit's own words)
docs/features/first_look.md5 (1)tuninga fixed model id#12122
docs/features/model-escalation.md1 (5)tuningescalate to Opus#12122, #12126
docs/features/model-review.md3 (2)tuningthe review ladder#12122
docs/DEVELOP.md18 (1)wordcold-read.ts and its key#12124
docs/EXTRACT.md11 (2)wordthe claude binary#12127
docs/ON-YOUR-MACHINE.md129 (1)wordthe CLI's login#12126
docs/STATUS.md139 (1)word"in the background with Claude Code"#12126
docs/VISION.md10 (1)wordharness list#12126 (stays: a list)
docs/design/audit.md81 (1)worda page's wording#12126
docs/ops/RED-TEAM.md23 (2)seamclaudeSettings sandbox#12122
docs/research/celld.md44 (1)wordthe CLI's bubblewrap policy#12122
README.md33 (1)word"needs the claude CLI"#12126, #12127
CLAUDE.md1 (4)tuningthe 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.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs