Skip to content

features.md

Latest commit

 

History

History
83 lines (59 loc) · 3.68 KB

features.md

File metadata and controls

83 lines (59 loc) · 3.68 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
Onboarding backup restore Restores the latest named backup or lets you choose a named backup manually when a fresh install or empty pool needs to recover saved accounts fast 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
Experimental settings hotkeys Keyboard shortcuts for sync preview, backup export, and refresh-guard tuning
Browser-first OAuth with manual fallback codex auth login stays browser-first, while --manual, --no-browser, and CODEX_AUTH_NO_BROWSER=1 keep login usable in browser-restricted shells

Manual/non-TTY login accepts the full callback URL on stdin, so automation and host-managed shells can complete auth without relying on a local browser handoff.

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