codex-lb¶
Load balancer for ChatGPT accounts. Pool multiple accounts, track usage, manage API keys, view everything in a dashboard.
 |
 |
|---|---|
Features¶
- Account pooling — load balance across multiple ChatGPT accounts
- Usage tracking — per-account tokens, cost, 28-day trends
- API keys — per-key rate limits by token, cost, window, model
- Dashboard auth — password + optional TOTP
- OpenAI-compatible — Codex CLI, OpenCode, any OpenAI client
- Auto model sync — available models fetched from upstream
Where to go¶
- Getting Started — Docker / uvx quick start, remote bootstrap token
- Client Setup — Codex CLI, OpenCode, OpenClaw, Python SDK
- Configuration — the few settings that matter
- Anonymous Telemetry — collected fields, consent, disabling, and retention
- Authentication — dashboard auth modes
- Conversations — dashboard view and conversation APIs
- API Keys — protecting proxy routes
- Routing — routing strategy guide
- Database — SQLite / PostgreSQL, data paths, Postgres upgrades
- Deployment — Docker, Kubernetes, remote access
- Troubleshooting
Screenshots¶
| Settings | Login |
|---|---|
 |
 |
| Dashboard (dark) | Accounts (dark) | Settings (dark) |
|---|---|---|
 |
 |
 |
Community companions¶
These independent projects consume the existing dashboard API and are maintained outside codex-lb:
- Codex LB Status Bar — a native macOS app with account status, quota details, and authenticated account controls.
- codex-lb SwiftBar — a read-only SwiftBar/Bun monitor for account-pool status and quota headroom.
Prefer a guest dashboard session for monitoring-only access when the companion supports it, and grant admin access only for Status Bar account controls. codex-lb SwiftBar is read-only; consult its compatibility table for the authentication modes supported by the current release. Review each project's repository and release notes before connecting it.
OpenSpec: the user-documentation capability governs this listing, while admin-auth defines the guest and admin access contracts.
codex-lb is spec-driven: normative behavior lives in OpenSpec capabilities in the repository. Docs pages describe how to use the project and link back to the specs that govern them.