coderouter CLI

coderouter - route Codex/Claude Code traffic across multiple ChatGPT Pro/Claude Max/OpenCode subscriptions and API keys.

cr add
cr codex
cr pi
cr naked

coderouter and cr are equivalent executable names. With no command, they show the account and usage summary. Agent routing is always explicit.

Commands

cr                           account and usage summary
cr codex [arguments...]       Codex through coderouter
cr opencode [arguments...]    OpenCode through coderouter
cr pi [arguments...]          Pi through coderouter (experimental)
cr naked [arguments...]       ordinary Codex, with coderouter bypassed
cr direct [arguments...]      alias for naked
cr add                        add Codex, Claude, or OpenCode Go interactively
cr add codex [--team ID]      add a personal or team ChatGPT workspace
cr add claude [--label NAME] [--team ID]  add a Claude Max or Pro setup token
cr add opencode [--team ID]   add OpenCode Go
cr remove [account] [--yes]   remove a subscription
cr transfer [account] [--to <team>] [--yes]
                              move a subscription to another team after a y/N prompt
cr accounts                   list available subscriptions
cr accounts --json --team ID  list one team's subscriptions without switching scope
cr list / cr ls                aliases for accounts
cr usage                      show quota state
cr doctor                     diagnose login and the Vercel data plane
cr login / cr logout          manage this machine's coderouter session
cr login --device-auth        copy a code into coderouter.dev/authorize
cr capabilities --json        report credential-free CLI capabilities
cr org current                show the active organization
cr org list                   list authorized coderouter organizations
cr org switch <name-or-id>    switch organization and routing credentials
cr upgrade                    open cmux Pro and Team pricing

Organization switching is fail-closed. The server returns only organizations where the signed-in user can use or manage coderouter, and the CLI persists the new scope only after receiving a new organization-scoped route token.

cr transfer moves one subscription from the active organization to another organization you manage. The account is an ID or exact label, and --to is a team ID or case-insensitive team name; either one opens a picker when omitted. Before sending, the CLI prints the account, provider, source team, destination team, and the consequence (the source team's members and Cloud machines stop using it; it keeps its current sharing in the destination), then asks Transfer? [y/N]. --yes (-y) skips the prompt. Without a terminal the command refuses to run unless --yes is present. Claude subscriptions cannot be transferred yet; remove and re-add them in the destination team.

The Ratatui add flow supports direct Codex OAuth/PKCE and OpenCode Go device authorization. Claude account setup runs the official claude setup-token flow, then accepts the token in a hidden prompt. Automation can use CLAUDE_CODE_OAUTH_TOKEN or --stdin. Tokens are never accepted in argv or included in coderouter output. The official Claude CLI can display the token as part of its setup flow. Normal agent credentials are untouched.

The production control plane is https://coderouter.dev. coderouter uses a separate session config and never overwrites normal agent configuration. CODEROUTER_API_URL can override the origin for staging and loopback tests.

Routing

The CLI routes directly to the Vercel data plane at coderouter.dev. It does not install Subrouter, a local daemon, Go code, or GCP tooling.

cr pi creates an ephemeral Pi provider extension for the current process. It captures the route token during extension startup and immediately removes it from Pi's process environment before tools can inherit it. It never writes the token to Pi config and leaves normal providers, settings, extensions, and sessions untouched.