spawn-probe
Records agent.spawn inputs and results
newagents
Records agent.spawn inputs and results
A Claude Code Mod that chooses a model and effort for each main-conversation turn, advised by a prompt classifier: Jev; Cloudflare's Clef, Clef Flash or Clef Omni; OpenAI; or a local Ollama model.
The Mod changes only the model and effort in Claude Code's turn hook. Claude Code sends the request, streams the reply, runs tools, and reports usage. The router does not proxy Anthropic traffic or start a local server; an Ollama classifier calls an Ollama server that you run. Subagents get one model each when they start, chosen the same way: every agent whose definition names no model, says model: inherit, or sets modelRouting: auto. Their steps are never re-routed. See Subagent routing.
The active classifier is asked at the start of each logical turn, for the tier and for the turn's activity, and again in the background every 4 requests while the turn runs (policy.reviewEveryRequests). Pick one on the pane's Classifier tab or in router.json; only the active one receives prompt text. With subagent routing on (the default), it is also asked once per routed subagent, with the task's description and prompt; set "subagentRouting": "off" to keep that text local.
| Classifier | Service | Credential | Prompt text goes to | How it is asked for the activity |
|---|---|---|---|---|
| Jev | typesafe.ai | Jev API key | typesafe.ai | A third choice question in the same request |
| Clef | Cloudflare Workers AI, 27B | Cloudflare API token and account ID | Cloudflare | The same |
| Clef Flash | Cloudflare Workers AI, 9B | Cloudflare API token and account ID | Cloudflare | The same |
| Clef Omni | Cloudflare Workers AI, 30B MoE | Cloudflare API token and account ID | Cloudflare | The same |
| OpenAI | OpenAI, gpt-6-luna (public beta) | OpenAI API key | OpenAI (api.openai.com) | A second choice in questions, in the same request |
| Ollama | A local Ollama model | None | Stays on this machine | A second request: letters A to H, one token, if 300 ms or more remain |
Jev is the default. Configuration gives the endpoints, timeouts, and how to add another service that speaks one of the supported protocols.
The band above the prompt shows the tier, activity, model, and reason for each turn. /router opens a pane to pin a tier, edit the model and effort of each tier, and tune the policy. See the user guide.
The router needs Claude Code 2.1.289 or newer. Savings are not measured. The pane's Usage tab estimates what routing cost against your own model for the same tokens at configured list prices, for this session, today, 7 or 30 days, this month or all; it is not a bill and does not judge answer quality. See the evaluation.
sequenceDiagram
actor Dev as Developer
participant Code as Claude Code
participant Mod as Router Mod
participant Cls as Classifier
participant API as Anthropic
Dev->>Code: Prompt
opt Subagent spawn
Code->>Mod: agent.spawn
Mod-->>Code: One model for the agent (on), or none (off)
end
Code->>Mod: Main or subagent step
alt Main conversation, routing on
Mod->>Cls: Bounded prompt and dialogue
Cls-->>Mod: Tier advice
Mod-->>Code: Selected model and effort
else Routing off or subagent step
Mod-->>Code: Original model and effort
end
Code->>API: Native request and tools
API-->>Code: Response stream and usage
Mod-->>Dev: Status band and router paneThe active classifier labels each new logical turn, and the router checks the route again while the task runs: a turn labelled ops that edits code moves up to the code route at once, and a background classifier review every 4 requests can move the tier or the activity either way. A cheaper route on the same task waits for a dwell and a passed test, build or lint run. See Changes during a task. A local policy applies vote, context, failure, and cache-cost rules before the Mod changes the next step. Claude Code owns request construction, model credentials, tools, streaming, and the API cost ledger.
| Tier | Default model | Effort |
|---|---|---|
micro | Haiku 5.5 | medium |
low | Haiku 5.5 | high |
medium | Opus 5.5 | medium |
high | Opus 5.5 | xhigh |
These are routing defaults. They do not claim equal model quality. Configuration gives the published results behind them and the router.json lines that restore the 1.3 Sonnet ladder.
Activity routing adds a second label: what the turn produces (code, debug, explore, plan, review, ops, or docs). A route is then picked by tier and activity. It is on by default since 1.7. A · cell uses the tier's own route, the base route:
| Activity | micro | low | medium | high |
|---|---|---|---|---|
| Base route | Haiku · medium | Haiku · high | Opus · medium | Opus · xhigh |
code, debug, plan, review | · | Sonnet · high | · | · |
ops | · | · | Haiku · high | · |
explore, docs | · | · | · | · |
/router activities off stops asking and keeps the base routes. Activity routing explains each cell and how to change it. The label is optional: on uncertain or a weak label the base route is used if the move passes the cache check, when the activity answer fails the running activity stays and the tier answer still applies, and when the classifier fails the running route stays. See Route by activity, and Evaluation for how it is checked. Its default overrides rest on published vendor results and a list-price replay of one developer's sessions, not measured savings.
You need Claude Code 2.1.289 or newer and credentials for one supported classifier.
claude plugin marketplace add alexei-led/claude-router
claude plugin install router@alexei-led-claude-routerStart Claude Code on the full baseline model, for example claude --model claude-haiku-5-5. Run /plugin configure router and save the key. For any other classifier, save its credentials, or run ollama serve with a pulled model, then pick the classifier on the pane's Classifier tab. A new session on a model that a tier routes to, or with activity routing on a model an activity override uses (Sonnet 5.5 on the defaults), starts with routing on; on any other model it starts with routing off and says why, and /router auto turns routing on.
Claude Code updates the plugin at startup when auto-update is on for this marketplace. Otherwise run claude plugin marketplace update alexei-led-claude-router, then claude plugin update router@alexei-led-claude-router.
Upgrading from 0.8? Remove the gateway settings that 0.8 /router:setup wrote before the first 1.0 session, or requests go to a gateway that 1.0 no longer starts. Follow the migration steps.
Start Claude Code with this directory as a local plugin and the full Haiku baseline model:
claude --plugin-dir "$PWD" --model claude-haiku-5-5In Claude Code, run /plugin configure router and save your classifier key in the sensitive plugin option. The Mod adds its status band and /router pane. No status-line setup or gateway environment variables are needed.
Run /router to open the pane: route status, per-tier controls, tuning, and usage, including routing vs your model. Run /model to select a model and turn routing off, and /router auto to turn it back on. For controls, metrics, tuning, and troubleshooting, see the user guide.
Before a push, run the same checks as CI. npm run setup installs Biome and TypeScript into tools/; the plugin root keeps no lockfile, so Claude Code installs nothing with the plugin. npm run validate and npm run test:plugin need the claude CLI: they load the Mod in the Claude Code engine, which refuses some faults that lint and unit tests miss.
npm run setup
npm run check && npm run typecheck && npm test && npm run validate && npm run test:pluginrouter.json, defaults, and migrations.hooks/probe.mjs 28 lines1// Records each agent.spawn input and result, and the first turn.step model of each agent loop, to $OUT.
2const rows = [];
3const seen = new Set();
4async function flush($) {
5 const out = await $.env.get('SPAWN_PROBE_OUT');
6 if (out) await $.fs.write(out, JSON.stringify(rows, null, 2));
7}
8export function register(on) {
9 on('agent.spawn', async ($, e, next) => {
10 const started = Date.now();
11 const m = /OVR:(\S+)/.exec(e.description) ?? /OVR:(\S+)/.exec(e.prompt);
12 const input = { ...e, prompt: e.prompt.slice(0, 120) };
13 const sent = m ? { ...e, model: m[1] } : e;
14 const result = await next(sent);
15 rows.push({ event: 'agent.spawn', input, override: m?.[1] ?? null, result, nextMs: Date.now() - started, budget: next.budget?.ms });
16 await flush($);
17 return result;
18 });
19 on('turn.step', async function* ($, e, next) {
20 if (e.agentId && !seen.has(e.agentId)) {
21 seen.add(e.agentId);
22 rows.push({ event: 'turn.step', agentId: e.agentId, model: e.model, effort: e.effort ?? null });
23 await flush($);
24 }
25 return yield* next(e);
26 });
27}
28