79 lines (56 loc) · 3.12 KB

Features

User-facing capability map for codex-multi-auth.

Manage More Than One Account

Capability	What it gives you	Primary entry
Multi-account dashboard login	Add and manage multiple OAuth identities from one terminal flow	`codex auth login`
Account dedupe and identity normalization	Avoid duplicate saved account rows	login flow
Explicit active-account switching	Pick the current account by index instead of relying on hidden state	`codex auth switch <index>`
Fast and deep health checks	See whether the current pool is usable before a coding session	`codex auth check`
Flagged-account verification and restore	Recover accounts that were sidelined during prior failures	`codex auth verify-flagged`

Decide Which Account To Use

Capability	What it gives you	Primary entry
Readiness and risk forecast	Suggests the best next account	`codex auth forecast`
Live quota probe mode	Uses live headers for stronger decisions	`codex auth forecast --live`
JSON report output	Lets you inspect account state in automation or support workflows	`codex auth report --live --json`

Recover From Local State Problems

Capability	What it gives you	Primary entry
Safe repair workflow	Detects and repairs known local storage inconsistencies	`codex auth fix`
Diagnostics with optional repair	One command to inspect and optionally fix common failures	`codex auth doctor`
Backup and WAL recovery	Safer persistence when local writes are interrupted or partially applied	storage runtime

Keep Account State Local And Predictable

Capability	What it gives you
Canonical local data root	Consistent storage under `~/.codex/multi-auth`
Project-scoped account pools	Repo-specific account state when you need separation
Linked-worktree identity sharing	The same repository can share account state across worktrees
Quota cache persistence	Faster forecast and dashboard visibility between runs

Improve Day-To-Day Terminal Use

Capability	What it gives you
Quick switch and search hotkeys	Faster navigation in the dashboard
Account action hotkeys	Per-account set, refresh, toggle, and delete shortcuts
In-dashboard settings hub	Runtime and display tuning without editing files directly
Browser-first OAuth with manual fallback	Works in normal and constrained terminal environments

Optional Plugin Runtime

Some users only need the wrapper and codex auth ... commands. If you also run the plugin-host path, codex-multi-auth can use the same account pool for:

request transformation for Codex or ChatGPT-backed flows
token refresh and refresh deduplication
retry, cooldown, and stream failover handling
session affinity and live account sync
capability and quota-aware account selection

Related