ndycode/codex-multi-auth

What it solves

codex-multi-auth addresses the limitation of the official OpenAI Codex CLI, which typically supports only one opaque authentication file. It allows developers to manage a pool of multiple ChatGPT accounts, switch between them deterministically, and handle account health and quotas more transparently.

How it works

The project provides a set of global binaries that manage OAuth credentials locally. It does not replace the official codex binary but instead offers a management tool (codex-multi-auth) and an optional forwarding wrapper (codex-multi-auth-codex). This wrapper intercepts commands and forwards them to the official CLI while managing the active account. It also includes a loopback-only proxy for live account rotation, which automatically switches accounts during active sessions to avoid rate limits.

Who it’s for

It is designed for developers using the Codex CLI in personal development workflows who need to manage multiple accounts, track usage across a pool, and ensure high availability through automatic failover and rotation.

Highlights

• Multi-Account Management: Explicit login, listing, and switching for multiple ChatGPT accounts.
• Automated Rotation: A loopback proxy that enables live account rotation for request-bearing sessions.
• Health Monitoring: Tools for quota forecasting, health checks, and diagnostics to identify and recover flagged accounts.
• Project-Scoped Storage: Ability to store account credentials specifically for different repositories or projects.
• Operational Toolkit: A comprehensive set of commands for repairing local state (doctor, fix), monitoring usage, and verifying account status.