codex-multi-auth Daily Guide

May 3, 2026 ยท View on GitHub

Daily-use guide for Codex CLI multi-account OAuth management with codex-multi-auth ...: login, account switching, health checks, runtime rotation status, diagnostics, and repair.

60-Second Path

codex-multi-auth login
codex-multi-auth list
codex-multi-auth check

If you are choosing an account for the next session:

codex-multi-auth forecast --live

Use This Section For

  • first setup and verification: getting-started.md
  • quick answers before install: faq.md
  • understanding the account manager, optional forwarding wrapper, runtime rotation proxy, app bind, and optional plugin-host path: architecture.md
  • recovering from login, routing, account switching, quota, or stale state problems: troubleshooting.md

Common Daily Commands

codex-multi-auth status
codex-multi-auth list
codex-multi-auth switch 2
codex-multi-auth report --live --json
codex-multi-auth doctor --fix

Canonical Policy

  • Canonical package: codex-multi-auth
  • Canonical command family: codex-multi-auth ...
  • Canonical storage root: ~/.codex/multi-auth
  • Runtime rotation: default-on, inspect or repair with codex-multi-auth rotation status

Legacy migration details live in upgrade.md.

Next References