@openai/codex CLI. It provides canonical account management workflows, intelligent failover, and operational safety features for development teams using ChatGPT Codex.
The legacy scoped prerelease package
@ndycode/codex-multi-auth is migration-only. Use codex-multi-auth for all new installs.Key features
Multi-account OAuth pool
Health-aware account selection with automatic failover when rate limits or quota issues are detected
Project-scoped storage
Per-project account storage under
~/.codex/multi-auth/projects/<project-key>/ with worktree supportInteractive dashboard
Manage accounts, check health, switch active accounts, and configure settings from a rich TUI
Operational safety
Built-in forecast, report, fix, and doctor commands for proactive health monitoring and recovery
Session affinity
Live account sync controls and proactive refresh with preemptive quota deferral
Flagged account recovery
Automatic verification and restore flow for accounts flagged by health checks
What you get
- Canonical workflow -
codex auth ...commands for login, switching, checks, and diagnostics - Intelligent routing - Health-aware selection with automatic failover on rate limits or errors
- Project isolation - Per-project account pools that follow your repository structure
- Rich diagnostics - Forecast, report, fix, and doctor commands with JSON output support
- Session recovery - Flagged account verification and automatic restore capabilities
- Fine-grained control - Session affinity, proactive refresh, and quota deferral settings
- Codex compatibility - Request/prompt compatibility with strict runtime handling
Get started
Installation
Install Codex Multi-Auth globally with npm, yarn, or pnpm
Quickstart
Go from zero to your first working multi-account setup in 60 seconds
Community and support
Codex Multi-Auth is an independent open-source project, not an official OpenAI product.- GitHub - ndycode/codex-multi-auth
- Issues - Report bugs or request features
- npm - codex-multi-auth