RouterRouter CLI

RouterRouter runs one OpenAI-compatible endpoint in front of the AI routers you already use. Provider keys stay in environment variables and process memory. There is no account, route database, or telemetry.

npm install -g routerrouter-cli
routerrouter init
routerrouter start

The default config routes from OpenRouter to Vercel AI Gateway. init can also configure Cloudflare AI Gateway and Ramp Router, ordered fallback, weighted first choice, per-router models, retries, and timeouts.

Point an OpenAI-compatible client at the URL printed by routerrouter start, use the printed local API key, and request the virtual model routerrouter/auto. Responses include x-routerrouter-upstream and x-routerrouter-trace headers.

Commands

routerrouter init
routerrouter doctor
routerrouter start

Run routerrouter --help for flags. The server binds to 127.0.0.1 by default. Set ROUTERROUTER_API_KEY to use a stable local API key. Binding to 0.0.0.0 or :: makes the endpoint reachable from other devices and should only be done on a trusted network.

RouterRouter uses the open-source Portkey AI Gateway for upstream protocol handling and streaming. See THIRD_PARTY_NOTICES.md.