Command Reference

May 22, 2026 ยท View on GitHub

This directory documents command behavior by command. Use codex-auth <command> --help for the shortest in-terminal usage form.

Commands

CommandDetails
listdocs/commands/list.md
logindocs/commands/login.md
importdocs/commands/import.md
exportdocs/commands/export.md
switchdocs/commands/switch.md
removedocs/commands/remove.md
aliasdocs/commands/alias.md
cleandocs/commands/clean.md
configdocs/commands/config.md
appdocs/commands/app.md

Shared Behavior

  • Commands resolve codex_home from CODEX_HOME, then HOME/.codex, then USERPROFILE/.codex on Windows.
  • Account selection commands use the same row ordering and display grouping.
  • --api explicitly selects the default remote usage and account-name refresh path for the current command.
  • --skip-api forbids remote refresh for the current command.
  • Local-only usage refresh can update the active account from local Codex rollout files when usable local data exists.