RouteKit documentation
Choose the shortest path from installation to a working, observable model route.
RouteKit documentation
RouteKit is a CLI and singleton daemon that gives coding tools and HTTP clients one stable, authenticated model gateway. Every namespaced model remains attached to its configured provider, credential owner, billing mode, protocol, and quota.
Pre-1.0 contract
This documentation describes the current RouteKit product contract. Routes and billing is authoritative for qualification and billing. RouteKit does not promise unlimited use; provider and subscription limits and terms still apply.
Start with a verified result
Install and start RouteKit
Install the CLI, configure a provider, start the local gateway, and verify namespaced models.
Choose a focused guide
Pick one workflow for a client, route, operation, or recovery task.
curl -fsSL https://github.com/velum-labs/routekit/releases/latest/download/install.sh | sh
routekit setup
routekit models listExpected result: the gateway is ready at http://127.0.0.1:8080, and the
wizard has explicitly configured one or more selected routes and a live default
model. For automation, use routekit config init --provider <provider> or
routekit config init --empty instead.
Choose by intent
Pool subscriptions
Enroll and route across eligible Claude Code or Codex accounts.
Connect coding tools
Launch qualified Codex or Claude Code builds through RouteKit.
Use the HTTP API
Call OpenAI, Anthropic, and Codex-compatible boundaries.
Configure routing
Define providers, aliases, catalog policy, and pool behavior.
Run remotely
Provision through SSH and put an operator-managed HTTPS front door in place.
Inspect and operate
Check status, usage, call attribution, logs, and diagnosis.
Look up commands
Jump to the concise CLI command reference.
Request flow
A requested provider/model selects exactly that route. Subscription exhaustion
can rotate within the same subscription kind; it does not silently invoke a paid
API-key route. Continue with routes and billing
before production or shared use.
Reference and trust
- Commands — exact CLI tasks and options.
- Configuration — router document and policy.
- Model catalog — names, discovery, and capability data.
- Client compatibility — exact qualified client builds.
- Packages and API — TypeScript package map.
- Privacy — stored data, telemetry, and trust boundaries.
- Changelog — documentation-visible product changes.
Every article links to its source and an edit action. The project is available on GitHub.

