Skip to content

Latest commit

 

History

History
127 lines (91 loc) · 3.74 KB

commands.md

File metadata and controls

127 lines (91 loc) · 3.74 KB

Command Reference

Complete command, flag, and hotkey reference for codex-multi-auth.

Canonical Command Family

Primary operations use codex auth ....

Compatibility aliases are supported:

  • codex multi auth ...
  • codex multi-auth ...
  • codex multiauth ...

Primary Commands

Command Description
codex auth login Open interactive auth dashboard
codex auth list List saved accounts and active account
codex auth status Print short runtime/account summary
codex auth switch <index> Set active account by index
codex auth check Run quick account health check
codex auth features Print implemented feature summary

Advanced Commands

Command Description
codex auth verify-flagged Verify flagged accounts and optionally restore healthy accounts
codex auth forecast Forecast best account by readiness/risk
codex auth report Generate full health report
codex auth fix Apply safe account storage fixes
codex auth doctor Run diagnostics and optional repairs

Common Flags

Flag Applies to Meaning
--json verify-flagged, forecast, report, fix, doctor Print machine-readable output
--live forecast, report, fix Use live probe before decisions/output
--dry-run verify-flagged, fix, doctor Preview without writing storage
--model <model> forecast, report, fix Specify model for live probe paths
--out <path> report Write report output to file
--fix doctor Apply safe repairs
--no-restore verify-flagged Verify only; do not restore healthy flagged accounts

Compatibility and Non-TTY Behavior

  • codex remains the primary wrapper entrypoint. It routes codex auth ... and the compatibility aliases to the multi-auth runtime, and forwards every other command to the official @openai/codex CLI.
  • In non-TTY or host-managed sessions, including CODEX_TUI=1, CODEX_DESKTOP=1, TERM_PROGRAM=codex, or ELECTRON_RUN_AS_NODE=1, auth flows degrade to deterministic text behavior.
  • The non-TTY fallback keeps codex auth login predictable: it defaults to add-account mode, skips the extra "add another account" prompt, and auto-picks the default workspace selection when a follow-up choice is needed.

Dashboard Hotkeys

Main Dashboard

Key Action
Up / Down Move selection
Enter Select/open
1-9 Quick switch visible/source account
/ Search accounts
? Toggle help
Q Back/cancel

Account Details

Key Action
S Set current account
R Refresh/re-login account
E Enable/disable account
D Delete account
Q Back

Settings Screens

Settings screen hotkeys are panel-specific:

  • Account List View: Enter Toggle | Number Toggle | M Sort | L Layout | S Save | Q Back (No Save)
  • Summary Line: Enter Toggle | 1-3 Toggle | [ ] Reorder | S Save | Q Back (No Save)
  • Menu Behavior: Enter Select | 1-3 Delay | P Pause | L AutoFetch | F Status | T TTL | S Save | Q Back (No Save)
  • Color Theme: Enter Select | 1-2 Base | S Save | Q Back (No Save)
  • Backend Controls: Enter Open | 1-4 Category | S Save | R Reset | Q Back (No Save)

Workflow Packs

Health and planning:

codex auth check
codex auth forecast --live --model gpt-5-codex
codex auth report --live --json

Repair and recovery:

codex auth fix --dry-run
codex auth fix --live --model gpt-5-codex
codex auth doctor --fix

Related