Skip to main content

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 or OpenCode Go interactively
cr remove [account] [--yes]   remove a subscription
cr accounts                   list available subscriptions
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.

The Ratatui add flow supports direct Codex OAuth/PKCE and OpenCode Go device authorization. Direct Codex authentication has an explicit portable-PTY fallback through the official CLI. 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.

Privacy-safe analytics

Signed-in CLI commands send a short, best-effort lifecycle event to the authenticated CodeRouter server. The closed schema contains only coarse command/agent/mode/outcome/failure/exit/duration/context categories and the CLI version. It never includes command arguments, prompts, output, credentials, tokens, account/team/user identifiers, names, labels, email, paths, URLs, or free-form errors. Delivery cannot fail a command and uses a 200 ms deadline.

Disable CLI analytics with either:

export DO_NOT_TRACK=1
# or
export CODEROUTER_TELEMETRY_DISABLED=1

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

coderouter-0.3.0-py3-none-win_amd64.whl (4.4 MB view details)

Uploaded Python 3Windows x86-64

coderouter-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.7 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

coderouter-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.5 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

coderouter-0.3.0-py3-none-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

coderouter-0.3.0-py3-none-macosx_10_12_x86_64.whl (4.5 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file coderouter-0.3.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: coderouter-0.3.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 4.4 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for coderouter-0.3.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 037802156ccdcbdb7e81c260729b4cbc7ac65b1e4ef55358e0da1a7e10f98288
MD5 0f36871d7fb04f36d03214d59f377106
BLAKE2b-256 c13b7b8793d72f7a292678ac05f95ba7d4cb1739808f69c976c8e3340a63795d

See more details on using hashes here.

Provenance

The following attestation bundles were made for coderouter-0.3.0-py3-none-win_amd64.whl:

Publisher: publish-pypi.yml on manaflow-ai/coderouter-releases

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file coderouter-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for coderouter-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 910ead5729ce1e1a4b26fd65d77dcfdc1dac9c864cfd05bf35e9c1c74360ccb1
MD5 019064923afcb50756290d1439334411
BLAKE2b-256 26859cfa0e02b374fc531b0719b5d6676b4944d5037961176be12c5d698f725b

See more details on using hashes here.

Provenance

The following attestation bundles were made for coderouter-0.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-pypi.yml on manaflow-ai/coderouter-releases

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file coderouter-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for coderouter-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 2c28052d857026c9e88108d4ec442ae684afbfba8b1d99d350eb363a75e349e4
MD5 1f5acfb7d0d28ec451e24fe0b1ea982c
BLAKE2b-256 70ce42918de050998183f3851a97119e61df0726d8019bad1bca81df5edaf194

See more details on using hashes here.

Provenance

The following attestation bundles were made for coderouter-0.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: publish-pypi.yml on manaflow-ai/coderouter-releases

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file coderouter-0.3.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for coderouter-0.3.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c5f1f0005a05a23c6d5c417e46c23496d0e6bc983c3e4ac1f22f604361c4c676
MD5 f12c1bf3a334b97922c8730532af0e50
BLAKE2b-256 8c93597bc998063350baa24be8900b6342d58bde35f4608cd2d9c77f69ca1a29

See more details on using hashes here.

Provenance

The following attestation bundles were made for coderouter-0.3.0-py3-none-macosx_11_0_arm64.whl:

Publisher: publish-pypi.yml on manaflow-ai/coderouter-releases

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file coderouter-0.3.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for coderouter-0.3.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 995e258d882aeaeab57631f5ada7c885d186e146a4e7f682afe88755d384f8ac
MD5 ced97b873ef216f95ee4243992ec8c1c
BLAKE2b-256 7e98b755b8cc1f3a83d11a25cc0492f47ce64f8abc9248574a2940e5c7bd8513

See more details on using hashes here.

Provenance

The following attestation bundles were made for coderouter-0.3.0-py3-none-macosx_10_12_x86_64.whl:

Publisher: publish-pypi.yml on manaflow-ai/coderouter-releases

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.3.1

5 files

This release

0.3.0 This release

5 files

0.2.3

5 files

0.2.2

5 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page