codex-multi-auth Documentation Portal

June 7, 2026 ยท View on GitHub

Public documentation for the codex-multi-auth Codex CLI multi-account OAuth manager. Start here for installation, ChatGPT OAuth account switching, runtime rotation, configuration, troubleshooting, release notes, and maintainer references.

Start Here

  1. Getting Started
  2. Daily-use landing page
  3. FAQ
  4. Troubleshooting

Daily Use

DocumentFocus
Daily-use landing pageCommon Codex CLI multi-account workflows, quick-start commands, and recovery shortcuts
faq.mdShort answers to common adoption questions
features.mdMulti-account OAuth, runtime rotation, diagnostics, recovery, storage, and dashboard capability map
configuration.mdStable defaults, precedence, and environment overrides
architecture.mdPublic system overview of the account manager, optional wrapper, storage, runtime rotation proxy, app bind, and optional plugin-host path
privacy.mdData handling and local storage behavior

Release History

Stable Releases

DocumentFocus
releases/v2.3.0-beta.1.mdCurrent prerelease notes (install via npm i -g codex-multi-auth@beta)
releases/v2.3.0-beta.0.mdPrior prerelease notes
releases/v2.2.2.mdCurrent stable release notes (install via npm i -g codex-multi-auth)
releases/v2.2.1.mdPrior stable release notes
releases/v2.2.0.mdPrior stable release notes
releases/v2.1.12.mdPrior stable release notes
releases/v2.1.11.mdPrior stable release notes
releases/v2.1.10.mdEarlier stable release notes
releases/v2.1.9.mdEarlier stable release notes
releases/v2.1.8.mdEarlier stable release notes
releases/v2.1.7.mdEarlier stable release notes
releases/v2.1.6.mdEarlier stable release notes
releases/v2.1.5.mdEarlier stable release notes
releases/v2.1.4.mdEarlier stable release notes
releases/v2.1.3.mdEarlier stable release notes
releases/v2.1.2.mdEarlier stable release notes
releases/v2.1.1.mdEarlier stable release notes
releases/v2.1.0.mdEarlier stable release notes
releases/v2.0.2.mdEarlier stable release notes
releases/v2.0.1.mdEarlier stable release notes
releases/v2.0.0.mdEarlier stable release notes
releases/v1.3.2.mdStable archive
releases/v1.3.1.mdStable archive
releases/v1.3.0.mdStable archive
releases/v1.2.7.mdStable archive
releases/v1.2.6.mdStable archive
releases/v1.2.5.mdStable archive
releases/v1.2.4.mdStable archive
releases/v1.2.3.mdStable archive
releases/v1.2.2.mdStable archive
releases/v1.2.1.mdStable archive
releases/v1.2.0.mdStable archive
releases/v1.1.10.mdStable archive
releases/v0.1.9.mdPre-1.0 stable archive
releases/v0.1.8.mdPre-1.0 stable archive
releases/v0.1.7.mdPre-1.0 stable archive
releases/v0.1.6.mdPre-1.0 stable archive
releases/v0.1.5.mdPre-1.0 stable archive
releases/v0.1.4.mdPre-1.0 stable archive
releases/v0.1.3.mdPre-1.0 stable archive
releases/v0.1.2.mdPre-1.0 stable archive
releases/v0.1.1.mdPre-1.0 stable archive
releases/v0.1.0.mdPre-1.0 stable archive
releases/v0.1.0-beta.0.mdArchived prerelease notes
releases/legacy-pre-0.1-history.mdArchived pre-0.1 changelog history

Repair

DocumentFocus
troubleshooting.mdRecovery playbooks for install, login, switching, and stale state
upgrade.mdMigration from legacy package and path history

Reference

DocumentFocus
reference/commands.mdCommands, flags, and hotkeys
reference/settings.mdDashboard and runtime settings
reference/storage-paths.mdCanonical and compatibility storage paths
reference/public-api.mdPublic API stability and semver contract
reference/error-contracts.mdCLI, JSON, and helper error semantics
releases/v2.1.7.mdEarlier stable release notes
releases/v2.1.6.mdEarlier stable release notes
releases/v2.1.5.mdEarlier stable release notes
releases/v2.1.4.mdEarlier stable release notes
releases/v2.1.3.mdEarlier stable release notes
releases/v2.1.2.mdEarlier stable release notes
releases/v2.1.1.mdEarlier stable release notes
releases/v2.1.0.mdEarlier stable release notes
releases/v2.0.2.mdEarlier stable release notes
releases/v2.0.1.mdEarlier stable release notes
releases/v0.1.0-beta.0.mdArchived prerelease reference
Release historyStable, previous, and archived release notes

Maintainer Docs

DocumentFocus
DOCUMENTATION.mdDocumentation governance contract
development/ARCHITECTURE.mdRuntime architecture and invariants
audits/README.mdHistorical audit archive policy
audits/MASTER_AUDIT.mdHistorical v1.2.7 audit snapshot; evidence is preserved, not current architecture guidance
development/GITHUB_DISCOVERABILITY.mdGitHub-facing metadata and presentation guidance
development/IA_FINDABILITY_AUDIT_2026-03-01.mdIA and findability baseline audit
development/CONFIG_FIELDS.mdComplete field and environment inventory
development/CONFIG_FLOW.mdConfiguration resolution flow
development/RUNBOOK_ADD_AUTH_COMMAND.mdSafe workflow for adding a new codex-multi-auth ... command
development/RUNBOOK_ADD_CONFIG_FIELD.mdSafe workflow for introducing a new config field
development/RUNBOOK_CHANGE_ROUTING_POLICY.mdSafe workflow for changing routing, retry, or fallback policy
development/REPOSITORY_SCOPE.mdOwnership map by repository path
development/RUNBOOK_ADD_AUTH_MANAGER_COMMAND.mdSafe workflow for adding a new codex-multi-auth ... command
development/RUNBOOK_ADD_CONFIG_FIELD_SAFELY.mdSafe workflow for introducing a new config/settings field
development/RUNBOOK_CHANGE_ROUTING_POLICY_SAFELY.mdSafe workflow for changing routing or account-selection policy
development/TESTING.mdValidation gates and test matrix
development/TUI_PARITY_CHECKLIST.mdDashboard UX parity checklist
benchmarks/code-edit-format-benchmark.mdBenchmark methodology and outputs

Governance