codex-multi-auth
by ndycode
Codex CLI multi-account OAuth manager with account switching, health checks, runtime rotation, diagnostics, and recovery tools for @openai/codex
386stars
35forks
TypeScript
Added 4/30/2026
CLI Toolsaccount-healthaccount-switchingchatgptcodexcodex-authcodex-clicodex-multi-accountdiagnosticsmulti-accountnodejsoauthoauth2openaipkcequota-managementrecovery-toolsresponses-apiruntime-rotationterminal-uitypescript
Installation
# Add to your Claude Code skills
git clone https://github.com/ndycode/codex-multi-authGetting Started
Guides for using cli tools skills like codex-multi-auth.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
- SkillsLLM Features GuideVoting, bookmarks, comments, comparison pages, and security scanning explained.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
Security ReportVerified
Last scanned: 5/30/2026
{
"issues": [
{
"type": "npm-audit",
"message": "brace-expansion: brace-expansion: Large numeric range defeats documented `max` DoS protection",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-05-30T14:59:52.709Z",
"npmAuditRan": true,
"pipAuditRan": true
}codex-multi-auth: multi-account OAuth for the official Codex CLI
codex-multi-auth is a multi-account OAuth manager for the official @openai/codex CLI. It gives Codex CLI users explicit ChatGPT account login, account switching, health checks, local diagnostics, project-scoped storage, and default-on runtime Responses rotation without taking over the official codex binary. Use codex-multi-auth ... for account management, or codex-multi-auth-codex ... only when you intentionally want the optional forwarding wrapper.
Use it when you need a local Codex CLI multi-account workflow with visible account state, safer recovery commands, and a loopback-only runtime rotation proxy for request-bearing forwarded Codex sessions.
[!NOTE] Legacy scoped prerelease package
@ndycode/codex-multi-authis migration-only. Usecodex-multi-authfor all new installs.
What You Get
- Codex CLI multi-account OAuth management with a dedicated
codex-multi-auth ...command family - Explicit ChatGPT account login, saved-account listing, account switching, health checks, and diagnostics
- Optional
codex-multi-auth-codex ...forwarding wrapper for official Codex CLI commands when you choose wrapper-launched sessions - Health-aware account selection, quota forecasting, automatic failover, and flagged-account recovery
- Project-scoped account storage under
~/.codex/multi-auth/projects/<project-key>/...for repo-specific workflows - Interactive terminal dashboard for account actions, settings, search, and hotkeys
- Forecast, report, fix, doctor, verify, monitor, and rotation commands for operational confidence
- Local usage ledger, budget guards, account policy controls, routing profiles, and model/account capability views
- Runtime counters, budget/cooldown state, and multi-auth probe visibility in
codex-multi-auth status/codex-multi-auth report - Default-on loopback Responses proxy for live account rotation inside forwarded Codex CLI/app sessions
- Optional loopback-only local bridge for
/health,/v1/models, and/v1/responses, protected by hashed local client tokens - Reversible packaged Codex app bind and user-level launcher routing helpers that do not patch official app binaries
- Session affinity, live account sync, proactive refresh, and preemptive quota deferral controls
- Codex-oriented request/prompt compatibility with strict runtime handling and documented error contracts
- Stable docs for install, configuration, troubleshooting, upgrade, public API, storage paths, and release notes
Why Developers Use It
codex-multi-auth makes local Codex account state visible and recoverable. Instead of one opaque auth file, you get a named account pool, deterministic account switching, health-aware selection, JSON diagnostics for automation, and safe repair commands for stale or damaged local state. The architecture is designed for personal development workflows: credentials stay local, runtime rotation is loopback-only, and official Codex install paths keep owning the codex command.
Current Architecture At A Glance
codex-multi-auth now ships three distinct global binaries:
| Binary | Purpose |
|---|---|
codex-multi-auth |
Primary account manager; accepts bare auth subcommands such as login, status, switch, forecast, and rotation status |
codex-multi-auth-codex |
Optional wrapper that handles auth ... locally and forwards every other command to the official Codex CLI |
codex-multi-auth-app-launcher |
Optional desktop launcher helper for supported user-level shortcuts and wrapper apps |
The package does not publish a global codex binary. Keep codex owned by the official OpenAI install path and use codex-multi-auth-codex ... only when you intentionally want this package's forwarding wrapper.
[!CAUTION] This project uses OAuth account credentials and is intended for personal development use.
By using this package, you acknowledge:
- This is an independent open-source project, not an official OpenAI product
- You are responsible for your own usage and policy compliance
- For production/commercial workloads, use the OpenAI Platform API
Installation
Option A: Standard install
npm i -g codex-multi-auth
Option B: Migrate from legacy scoped prerelease
npm uninstall -g @ndycode/codex-multi-auth
npm i -g codex-multi-auth
Option C: Verify wiring
codex --version confirms the official Codex CLI is reachable. codex-multi-auth --version confirms the installed manager package version. codex-multi-auth-codex --version is the optional forwarding wrapper entrypoint.
codex --version
codex-multi-auth --version
codex-multi-auth status
Any official install path is fine as long as codex is on PATH: npm i -g @openai/codex, brew install --cask codex, or an official release binary.
Step-by-step
- Install global package:
npm i -g codex-multi-auth
- Run first login flow with
codex-multi-auth login - Validate state with
codex-multi-auth statusandcodex-multi-auth check - Confirm routing with
codex-multi-auth forecast --live
Verification
codex-multi-auth status
codex-multi-auth check
Quick Start
Install and sign in:
npm i -g @openai/codex
npm i -g codex-multi-auth
codex-multi-auth login
If you already installed the official native CLI via Homebrew or a release binary, you only need:
npm i -g codex-multi-auth
codex-multi-auth login
Verify the manager and the new account:
codex-multi-auth status
codex-multi-auth check
Use these next:
codex-multi-auth list
codex-multi-auth switch 2
codex-multi-auth forecast --live
If browser launch is blocked, use the alternate login paths in docs/getting-started.md.
For remote or headless shells, prefer codex-multi-auth login --device-auth.
Command Toolkit
Start here
| Command | What it answers |
|---|---|
codex-multi-auth login |
How do I add or re-open the account menu? |
codex-multi-auth status |
Is the wrapper active right now? |
codex-multi-auth check |
Do my saved accounts look healthy? |
Daily use
| Command | What it answers |
|---|---|
codex-multi-auth list |
Which accounts are saved and which one is active? |
codex-multi-auth switch <index> |
How do I move to a different saved account? |
codex-multi-auth-codex --account <index|email|id> |
How do I force one account for a single wrapper session without changing my default? |
codex-multi-auth forecast --live |
Which account looks best for the next session? |
Repair
| Command | What it answers |
|---|---|
codex-multi-auth verify-flagged |
Can any previously flagged account be restored? |
codex-multi-auth verify --paths |
Do my storage path chain and sandbox probes still pass self-test? |
codex-multi-auth fix --dry-run |
What safe storage or account repairs are available? |
codex-multi-auth doctor --fix |
Can the CLI diagnose and apply the safest fixes now? |
codex-multi-auth uninstall |
Remove residual artifacts (run BEFORE npm uninstall; npm@7+ no longer fires preuninstall) |
Advanced
| Command | What it answers |
|---|---|
codex-multi-auth report --live --json |
How do I get the full machine-readable health report? |
codex-multi-auth fix --live --model gpt-5.5 |
How do I run live repair probes with a chosen model? |
codex-multi-auth why-selected --json |
Which account does the selector pick now, and why? |
codex-multi-auth usage --since 24h --by project |
What local usage has been recorded recently? |
codex-multi-auth monitor --json |
What is the combined usage, policy, quota, runtime, and project state? |
codex-multi-auth bridge token create --label local-client |
How do I create a local bridge bearer token? |
codex-multi-auth integrations --kind python |
How do I generate local bridge client snippets? |
codex-multi-auth rotation status |
Is live runtime account rotation enabled for forwarded Codex sessions? |
Reliability behavior
- whole-pool replay is disabled by default when every account is rate-limited
- active requests use a bounded outbound request budget so one prompt cannot walk the full pool indefinitely
- repeated cross-account 5xx bursts trigger a short cooldown instead of continuing aggressive rotation
- proactive refresh is staggered to reduce background refresh bursts
codex-multi-auth statussurfaces recent runtime request metrics in text output, andcodex-multi-auth report --jsonexposes the machine-readable cooldown/runtime snapshot
Dashboard Hotkeys
Main dashboard
| Key | Action |
|---|---|
Up / Down |
Move selection |
Enter |
Select/open |
1-9 |
Quick switch |
/ |
Search |
? |
Toggle help |
Q |
Back/cancel |
Account details
| Key | Action |
|---|---|
S |
Set current account |
R |
Refresh/re-login account |
E |
Enable/disable acco |
Frequently Asked Questions
What is codex-multi-auth?
codex-multi-auth is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ndycode. Codex CLI multi-account OAuth manager with account switching, health checks, runtime rotation, diagnostics, and recovery tools for @openai/codex. It has 386 GitHub stars.
Is codex-multi-auth safe to use?
Yes. codex-multi-auth passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install codex-multi-auth?
Clone the repository with "git clone https://github.com/ndycode/codex-multi-auth" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is codex-multi-auth written in?
codex-multi-auth is primarily written in TypeScript. It is open-source under ndycode on GitHub, so you can review or fork the full source.
Are there alternatives to codex-multi-auth?
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh codex-multi-auth against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
196,117
59,263
TypeScript
MCP Serversaiapis
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
116,055
7,773
Rust
AI Agentsai-toolsclaude-code
An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms
104,444
11,053
Python
CLI Toolsai-skillsantigravity
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs, papers, images, or videos into a queryable knowledge graph. App code + database schema + infrastructure in one graph.
82,544
8,141
Python
AI Agentsantigravityclaude-code
Production-grade engineering skills for AI coding agents.
77,397
8,303
JavaScript
AI Agentsagent-skillsantigravity
Popular in CLI Tools
Top skills in this category by stars
CLI tool for configuring and monitoring Claude Code
29,077
3,189
Python
CLI Toolsanthropicanthropic-claude
Mobile and Web client for Codex and Claude Code, with realtime voice, encryption and fully featured
22,579
1,902
TypeScript
CLI Toolsclaude-codeclaude-desktop