pi-gearshift

Automatic per-turn model and thinking-level routing for Pi, powered by Jev

Packages

Package details

extension

Install pi-gearshift from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-gearshift
Package
pi-gearshift
Version
0.2.0
Published
Sep 24, 2026
Downloads
388/mo · 13/wk
Author
iharuya
License
MIT
Types
extension
Size
630.3 KB
Dependencies
2 dependencies · 3 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/iharuya/pi-gearshift/main/assets/what-is-this.png",
  "extensions": [
    "./extensions/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-gearshift

pi-gearshift routes every request to the right gear

Let Jev choose the model and thinking level for each turn in the Pi Coding Agent.

  • light — straightforward, low-risk work
  • standard — typical implementation and debugging
  • heavy — deep, ambiguous, broad, or high-risk work

Get started

pi install npm:pi-gearshift
pi

The setup wizard guides you through choosing models and thinking levels for each gear. It asks for a TypeSafe API key for automatic routing.

You can configure by /gearshift settings or editing ~/.pi/agent/pi-gearshift/settings.json manually.

Commands

Command Purpose
/gearshift status Show current configuration and authentication status
/gearshift settings Configure gears and routing bias
/gearshift use light|standard|heavy Switch gears manually, even when automatic routing is disabled
/gearshift enable Enable automatic routing
/gearshift disable Disable automatic routing
/gearshift login Save a TypeSafe API key
/gearshift logout Remove the saved key and disable automatic routing

You can also supply your key through TYPESAFE_API_KEY. Set PI_GEARSHIFT_DATA_DIR to change the data directory.

How it works

Before each turn, Jev evaluates the request and Gearshift selects a model and thinking level. If routing fails, Pi continues with its current setting without retrying.

Routing sends your complete request and a limited number of recent user or assistant messages to TypeSafe. Recent messages are shortened to a limited length; thinking blocks, tool calls, and tool results are excluded.

License

MIT