codex auth status

Display a quick overview of the current account state, including active account, total count, and storage location.

Usage

codex auth status

No options or arguments required.

Output Format

The command prints:

Total account count
Storage file path
Numbered list of accounts with status markers
Last-used timestamp for each account

Example Output

Accounts (4)
Storage: /home/user/.codex/multi-auth/openai-codex-accounts.json

1. [email protected] [current] used 15 minutes ago
2. [email protected] used 2 hours ago
3. [email protected] [disabled] used 3 days ago
4. [email protected] [rate-limited, cooldown:1h30m] used 45 minutes ago

Status Markers

current

marker

This account is active for API requests.

disabled

marker

Account is disabled and won’t be used for rotation.

rate-limited

marker

Account hit rate limits and is temporarily unavailable.

cooldown:duration

marker

Account in cooldown period. Shows remaining time (e.g., 1h30m, 45s).

Multiple Markers

Accounts can have multiple status markers:

4. [email protected] [rate-limited, cooldown:2h15m] used 1 hour ago

This means the account is both rate-limited and cooling down for 2 hours 15 minutes.

Account Labels

Each account shows the first available identifier:

Email address - Preferred (e.g., [email protected])
Custom label - If set (e.g., Work Account)
Account ID - From token (e.g., user-abc123)
Token prefix - Fallback (e.g., token-xyz789...)

Timestamp Format

Last-used times are shown as relative durations:

never used - Account hasn’t been used yet
used 5 seconds ago
used 3 minutes ago
used 2 hours ago
used 4 days ago

Timestamps update when:

API requests succeed
Tokens are refreshed
Accounts are manually switched

Empty State

No accounts configured.
Storage: /home/user/.codex/multi-auth/openai-codex-accounts.json

Run codex auth login to add accounts.

Exit Codes

0 - Always succeeds (even with zero accounts)
1 - Storage read failure

Examples

Quick status check

codex auth status

Verify active account

codex auth status | grep current

Count total accounts

codex auth status | head -1
# Output: Accounts (4)

Check for rate-limited accounts

if codex auth status | grep -q rate-limited; then
  echo "Some accounts are rate-limited"
  codex auth forecast --live
fi

Comparison with Other Commands