CLI to manage multiple Codex accounts by profile and promote one account to the default profile (~/.codex) used by Codex App + Codex CLI when CODEX_HOME is not set.

• npm i -g @anewryzm/codex-use

• Primary: codex-use
• Short alias: cdex

• tools/codex-use

1. Save login per profile:

• codex-use login personal
• codex-use login work

2. Switch the active default account:

• codex-use use personal
• codex-use use work
• codex-use use work --relaunch (recommended so Codex App refreshes the session automatically)
• codex-use use work --relaunch --from-action (for Actions: relaunches the app and closes the Terminal tab on success)

3. Check usage/rate limits:

• codex-use usage
• codex-use usage --json
• codex-use limits work --refresh
• codex-use limits --all or codex-use limits -a (compact limits view by profile)

• codex-use login <profile>
• codex-use use <profile> [--force] [--relaunch] [--from-action]
• codex-use add switch action [--platform <macos|darwin>] [--icon <icon>] [--command-name <cdex|codex-use>] [--dry-run]
• codex-use delete switch action [--platform <macos|darwin>] [--dry-run]
• codex-use usage [--json]
• codex-use backup [--note "..."] [--dir <path>] [--delete]
• codex-use backup status [--dir <path>]
• codex-use backup init [--dir <path>]
• codex-use backup add remote <url> [--name <remote>] [--dir <path>]
• codex-use backup push [--remote <name>] [--branch <name>] [--dir <path>]
• codex-use backup restore [--dir <path>] [--relaunch] [--delete]
• codex-use limits [profile|default] [--all] [--json] [--refresh]
• codex-use list
• codex-use whoami
• codex-use status <profile> [--refresh]
• codex-use logout <profile>
• codex-use logout-default

• use creates an automatic backup of ~/.codex/auth.json in ~/.codex/backups/.
• Avoid switching accounts while there are active tasks in Codex App.
• --force exists for advanced cases and may interrupt in-flight sessions.
• --relaunch closes and reopens Codex App so the UI reads the new auth.json.
• --from-action is intended for Codex Actions: after a successful --relaunch, it tries to auto-close the current Terminal tab.
• usage reads local history from ~/.codex/sessions.
• backup snapshots ~/.codex/sessions into a Git repo (default: ~/codex-history-backup).
• backup is copy-only by default (no deletions). Use --delete only when you intentionally want mirror mode.
• limits queries codex app-server using JSON-RPC (initialize, account/read, account/rateLimits/read).

1. Run codex-use list.
2. Check the legend:

• [*] = the profile uses exactly the same token as ~/.codex.
• [~] = same account_id, but different token/identity.

3. If you switch while the app is open, use codex-use use <profile> --relaunch.
4. Run codex-use whoami to see Active profile plus email/plan/account.

• whoami: quick view of the active profile in ~/.codex (the account used by app/CLI by default).
• status <profile>: diagnostics for a specific profile in ~/.codex-profiles/<profile>, including:
• identity summary (plan, default_org, email, account_id)
• usage limits (5h and weekly) with remaining percentage, horizontal bar, and reset timing
• readable credits summary (credits: none, credits: unlimited, credits: balance ...)
• Use --refresh to force a fresh backend query before showing limits.

• usage shows historical consumption from ~/.codex/sessions in a compact table.
• Columns: in(M), out(M), cach(M) (millions of tokens). out(M) includes reasoning.
• usage --json returns the raw aggregate (totals and models) for scripting.

• limits <profile> (without --json) shows dashboard-style output: 5h and weekly bars, natural-language reset, and credits summary.
• limits --all/limits -a shows a compact table with columns profile, email, 5h (reset), weekly (reset) and a Current default profile line.
• limits --json keeps the raw JSON output from rate limits for scripting/automation.

• backup status shows backup health in terminal-first format (key: value), including repo/git state, source vs backup file counts, session-id coverage, and pending copy/delete deltas.
• pending_copy_files indicates what would be copied in default mode.
• pending_new_files indicates brand-new rollouts not yet present in backup.
• pending_modified_files indicates existing rollout files that changed (for example, more conversation appended to the same .jsonl).
• pending_mirror_deletes indicates what would be removed only in --delete mirror mode.
• runtime_unflushed_activity indicates there is fresh Codex runtime activity (logs_2.sqlite / state_5.sqlite) newer than the latest sessions/*.jsonl write.
• runtime_vs_sessions_lag_seconds indicates how far runtime activity is ahead of session-log writes.

• backup commits now include a Session notes section with only new/changed rollouts since the previous backup commit (not a cumulative list).
• Each note line includes rollout file, resolved title (when available), model, token total snapshot, and latest timestamp.

• add switch action reads logged profiles from ~/.codex-profiles and writes per-profile switch actions into .codex/environments/environment.toml.
• Platform support for now: macos (alias: darwin, written as darwin in the TOML file).
• Example:
• codex-use add switch action --platform macos
• Preview only:
• codex-use add switch action --dry-run
• Delete generated switch actions for macOS:
• codex-use delete switch action --platform macos