How does pi-gear-router pick a model tier with Jev?

Jev scores the next step's capability need on a continuous 0-2 scale; the extension cuts that range into five bands that jointly select a three-gear model tier and a thinking level. The classifier estimates the lowest capability tier that can complete the task, so ordinary refactoring and debugging are not squeezed into only cheap or expensive models.

Does every message trigger a Jev classification call?

No. Substantive new requests are evaluated, but short continuation messages like "continue" or "go on" can inherit the current model for up to three turns, configurable via maxInheritedTurns. Tool follow-ups and failure retries inside a turn keep the already dispatched physical model and thinking level.

What do I need installed to use pi-gear-router?

Pi 1.1.0 or newer and valid credentials for your model provider. Set `TYPESAFE_API_KEY`, confirm it with `pi auth check --provider typesafe`, install the package with `pi install /path/to/pi-gear-router`, and select the virtual model `gears/auto`.

How do I make the router the default model?

Set `defaultProvider` to `gears` and `defaultModel` to `auto` in ~/.pi/agent/settings.json. If you already use `enabledModels`, add `gears/**` to that list rather than overwriting your existing entries.

Does the router send my tool output, thinking or images to Jev?

No. The README states the classifier input never includes thinking, raw tool output or arguments, or image data. It is bounded to about 16,000 characters of the current request, 4,000 for the task anchor, 3,000 for recent changes and 3,000 for three assistant messages.

Can the three gears point at different providers?

Yes. The gears are light, standard and heavy, and each can map to a different provider and model. `src/defaults.ts` ships generic Anthropic Haiku, Sonnet and Opus defaults plus a local Magpie gateway example, and the README says to configure them in ascending capability order.

What happens when a request is just a plain continuation?

Fully plain-text continuations are a conservative whitelist, not general intent recognition: exact phrases like 'continue' can inherit the previous model and thinking level for up to three turns, and after that the next turn is re-evaluated. Image attachments and unclear references do not inherit.

CommunityJev Tools & CLIs

Pi Gear Router

Pi extension that has Jev score each user request on a continuous 0-2 scale and cuts that range into five bands choosing one of three model gears (light, standard, heavy) plus a thinking level. A plain "continue" can inherit the current gear without a new Jev call.

See highlights

Open github.com

Stars: 0
Language: JavaScript
License: MIT
Published by: Community
Last verified: Oct 2026

joslynSmall/pi-gear-router

User repository on GitHub

View on GitHub

Per-turn three-gear model routing for Pi, judged by TypeSafe Jev. Built on Pi virtual models.

Forks: 0
Last pushed: Updated Oct 2026

Repo stats from the GitHub API, cached Oct 2026.

Tagscommunity model-routing pi cost-control

Works forJev for Routing Jev for Scoring

Used inJev for Software & DevTools

Languages: JavaScript
Platforms: CLI
Capabilities: Open sourceRequires API key

Highlights

Jev returns a score from 0 to 2 that maps to five bands across three model tiers.
Bands 0.5-1.0 and 1.0-1.5 share the standard gear but differ in thinking level.
A plain "continue" may skip evaluation for up to three inherited turns by default.
Requires Pi 1.1.0+ and installs as a virtual model picked with pi --model gears/auto.
gearBias shifts the raw score by up to 0.4 toward cheaper or stronger gears.

Watch out

MIT licensed. Needs a TypeSafe API key for judgments; with routing disabled or no key it falls back to the most recent physical model or the standard gear. A timeout degrades rather than blocking, and gear switching can lose a provider's prompt cache.

Questions about this entry

Short answers drawn from the linked project or page.

More Jev resources like this

JevCI

CLI quality gate that asks four typed questions about each change - three Score lenses for commit quality, doc alignment and breaking-API risk, plus a Noul secret audit - and fails a diff, commit message or doc set below the resulting 0-100 score. Runs from a terminal, a git pre-commit hook or a GitHub Action.

Jev Tools & CLIs#community#quality-gate#ci-cd

Community

sumant1122/jevciJavaScript

decision-router

A CLI, Claude Code plugin and Pi extension that pick a model per task from one Jev call: a Choice over candidates asked in both orders plus a complexity Score that sets a minimum tier, with quota-aware filtering and fallback.

Jev Tools & CLIs#community#routing#claude-code

Community

Ruivalim/decision-routerTypeScript

jcode

20.4k

Rust coding-agent harness (MIT, ~20k stars) whose crates/jcode-base/src/jev.rs is a typed TypeSafe Jev decision transport, used for memory pruning (memory_jev.rs), browser navigation (browser_jev.rs), and voice routing (voice_intent.rs) with separate provider selectors per purpose.

Jev Tools & CLIs#community#rust#coding-agent

Community

1jehuang/jcodeRust

pyGPT

A desktop AI assistant with a Jev / System One inline plugin for classification, routing, verification, and scoring without chat-style output.

Jev Tools & CLIs#community#python#desktop

Community

szczyglis-dev/py-gptPython

Paca

1.9k

A Go-based team workspace with optional Jev AI for agent auto-routing, task auto-fill, auto-assign, and automation condition nodes.

Jev Tools & CLIs#community#go#agents

Community

Paca-AI/pacaGo

surf

634

A CLI browser automation tool with optional Jev semantic mode: Surf observes, Jev selects the next action, Surf validates and acts, Jev checks the goal.

Jev Tools & CLIs#community#browser#cli

Community

nicobailon/surf-cliTypeScript

From the Jev guides

Original write-ups on what this entry is for.

Jev on the Gateways: Vercel, Workers AI, and OpenRouter

Oct 12, 2026

The request shape barely changes across surfaces; the surrounding contract does. When to call the API directly and when a gateway, a Worker binding, or a router entry earns its extra hop.

Jev Tools & CLIs#gateway#vercel#cloudflare

Read article

Exporting Decision Models: GGUF, ONNX, and Device Runtimes

Oct 10, 2026

Taking a decision checkpoint out of Python: what the GGUF and browser WebGPU exports preserve, what they change, and the parity evidence the model cards publish.

Jev Tools & CLIs#open-models#local#onnx

Read article

Records at Rest: Documents, Inboxes, and Risk Queues

Sep 28, 2026

Jev labels a record that already exists. Code moves, flags, or holds it. How the document, mail, and transfer tools keep the action out of the model.

Jev Tools & CLIs#classification#email#security

Read article

Back to all resources

From the Jev community

Posts from builders shipping with Jev right now.

Follow @typesafeai