What is jev-router?
-Using one model for everything wastes money: an expensive model renames a variable, a cheap one stalls on a hard refactor. jev-router is a Claude Code plugin (a "mod") that asks TypeSafe Jev which Claude model and effort a task needs, then runs the turn on that choice. It works per prompt, again before each step of a long task, and once for every subagent.
-
-
-Where jev-router shines
-If your default is Opus, most prompts pay for more model than they need. Measured with real Claude Code runs, against always using Opus:
-| Your work | What it does | Result |
|---|---|---|
| Small tasks: renames, typos, lookups | Haiku, low effort | −97% cost |
| Everyday features, tests, refactors | Sonnet | −65% cost |
| Multi-step agent runs with tools and subagents | Routes each step and subagent | 18/18 done at 47% of the cost |
Hard tasks graded by hidden tests (the default lean preset) | Sonnet, medium effort, Opus only when Jev is 90% sure | 39/40 done at −61% cost |
30 mixed single prompts (balanced preset) | Effort capped at high | −1% to −64%, never above Opus |
Out of the box (0.4.0) jev-router runs the lean preset: a Sonnet ceiling and effort capped at medium. /jev preset balanced restores the earlier behaviour.
Best for: Opus-by-default users, workloads full of small prompts, agent runs with subagents, and anyone who wants to see and steer which model runs. Not for: long sessions on one big warm context (there lean averaged the same cost as Opus), or work where plain Sonnet is already enough.
Install
-You need Claude Code with plugin support and a TypeSafe API key.
+Install the Claude Code plugin
/plugin marketplace add dominicrico/jev-router
/plugin install jev-router@jev-router
-Then give it your key with /jev key <key> or the TYPESAFE_API_KEY environment variable, and run /jev status.
Then /jev key <your TypeSafe key> (or set TYPESAFE_API_KEY) and run /jev status. That is the whole setup: the lean preset is on by default.
+
+See every pick, live
+
+
+What you get
+
+
+
+Does it reduce Claude Code costs?
+Yes, on most work, and the benchmarks say where it does not. Every number is a real Claude Code run (hard tasks are graded by hidden tests the agent never sees), and the raw runs are in the benchmarks folder.
+
-Features
-medium by default, because extra reasoning is what makes hard tasks expensive. !full lifts it for one prompt./jev ceiling sonnet keeps tasks off Opus unless Jev is 90% sure. A sonnet ceiling finished 20/20 hard tasks at half the cost of Opus.!opus, !sonnet, !haiku pin a model with no Jev call; !cheap and !efficient set the mode./jev status estimates your saving against the model you would otherwise use.Is it for you?
+
+Long warm sessions are the honest weak spot: the cache guard cuts model switches from 6 to 1 and halves cache re-writes, but the bill stayed the same, and lean averaged Opus cost there while plain Sonnet was 43% cheaper.
-Does it save money? The benchmarks
-Everything is measured with real Claude Code runs and reproducible scripts. The honest summary: it saves a lot on easy and medium work, costs more than plain Sonnet on harder work, and with the default effort cap no mode costs more than always using Opus.
-
-| Cost vs always Opus | efficient | balanced | cheap |
|---|---|---|---|
| Trivial tasks | −97% | −97% | −97% |
| Standard tasks | −65% | −65% | −68% |
| Hard tasks (effort capped at high) | +43% | +24% | −56% |
| All 30 tasks | −1% | −13% | −64% |
-
-On the harder, hidden-test-graded tasks plain Sonnet did as well as Opus and cost 61% less. The default lean preset finished 39 of 40 at 61% below Opus. In long warm sessions routing did not beat staying on one model (the cache guard halves cache re-writes but not the bill), so routing helps most when your tasks vary, your context is small or cold, or your default is Opus. Method, limits and raw results are in the benchmarks folder.
Commands
+
+Every option, preset and the privacy details are in the reference.
FAQ
-How do I switch between Opus, Sonnet and Haiku automatically in Claude Code?
Install jev-router. It picks the model per prompt, and you can override one prompt with !opus, !sonnet or !haiku.
How do I reduce Claude Code token cost?
Route easy tasks to cheaper models and cap reasoning effort. jev-router does both, and shows an estimated saving in /jev status. The benchmarks above show where it helps and where it does not.
Does the prompt cache guard work?
It does what it says on switches: in real long sessions with a large warm cache it cut model switches from 6 to 7 down to 1 and halved cache re-writes. It did not lower the bill: with and without the guard routing cost +42% against Opus. The default lean preset averaged the same as Opus there (+0%), cheap in some sessions and dear in others, while plain Sonnet was -43%. For long warm sessions on one big context, plain Sonnet is the cheapest safe choice.
What is the effort cap?
Jev often asks for xhigh effort on hard tasks, which can use several times the tokens. The cap limits it to high by default. Start a prompt with !full to lift it once.
Does it send my code anywhere?
It sends the prompt text, optionally recent messages, and subagent task descriptions to api.typesafe.ai. API keys, tokens, private keys and password= style values are redacted first, and sendHistory turns the history off. Pattern redaction is not a guarantee.
How do I switch between Opus, Sonnet and Haiku automatically in Claude Code?
Install jev-router. It picks per prompt, again before each step, and once per subagent. Pin one prompt with !opus, !sonnet or !haiku.
How do I reduce Claude Code token cost?
Send easy tasks to cheaper models and cap the reasoning effort. jev-router does both: small tasks −97%, everyday work −65% against always Opus. If plain Sonnet already does your work, use that; it was cheapest on the hard set.
What is the effort cap?
Jev often asks for xhigh reasoning on hard tasks, which can triple the tokens. The default lean preset limits effort to medium; !full lifts it for one prompt.
Does the prompt cache guard work?
On switches, yes: 6 to 7 down to 1, and cache re-writes halve. It did not lower the bill in long warm sessions, where plain Sonnet is the cheapest safe choice.
Does it send my code anywhere?
The prompt, optionally recent messages, and subagent task text go to api.typesafe.ai. Keys, tokens, private keys and password= style values are redacted first, and sendHistory turns the history off. Pattern redaction is not a guarantee.
Will it slow Claude Code down?
Each Jev call adds about 250 ms. After three failed calls in a row it pauses for a minute and keeps the current model.
Which models does it use?
Claude Haiku, Sonnet, Opus and Fable, narrowed by the models option.