@imdeadpool/codex-account-switcher
Advanced tools
A command-line tool that lets you manage and switch between multiple Codex accounts instantly, no more constant logins and logouts.
multi-account Codex auth switching for local CLI workflows
save named auth snapshots, switch accounts instantly, and keep each terminal pinned to the right login
About · Install · Usage · Commands · Auto-switch · Service
A command-line tool that lets you manage and switch between multiple Codex accounts instantly, no more constant logins and logouts.
[!WARNING] Not affiliated with OpenAI or Codex. Not an official tool.
Codex stores your authentication session in a single auth.json file. This tool works by creating named snapshots of that file for each of your accounts. When you want to switch, codex-auth swaps the active ~/.codex/auth.json with the snapshot you select, instantly changing your logged-in account.
codex-auth also keeps a lightweight per-terminal session memory (scoped by shell parent PID by default), so older terminals keep using their original snapshot even if a different terminal logs into another account later.
npm i -g @imdeadpool/codex-account-switcher
During global install, the package asks for permission to add an optional shell hook
(~/.bashrc or ~/.zshrc) that auto-runs a silent snapshot sync after successful
official codex login.
On later global updates, if the hook is already installed, codex-auth refreshes the
hook block automatically to the latest template (no manual remove/setup needed).
The refreshed hook always wraps codex in your shell so sync/restore still run even if
another shell config already defined codex as a function.
Choose y to enable fully automatic login snapshot capture.
Choose n (default) to skip.
Set CODEX_AUTH_SKIP_POSTINSTALL=1 to always suppress this prompt.
Set CODEX_AUTH_SKIP_TTY_RESTORE=1 to keep the hook from restoring terminal modes after codex exits.
Set CODEX_AUTH_SESSION_KEY=<id> to explicitly scope session-memory identity (optional; default uses shell PPID).
For a calmer Codex footer, prefer a focused [tui] status_line such as:
[tui]
status_line = ["model-with-reasoning", "git-branch", "context-remaining"]
This remains a manual Codex config choice; codex-auth does not rewrite ~/.codex/config.toml.
# login to Codex and immediately snapshot the refreshed auth session
codex-auth login [name]
# headless/remote login flow + snapshot
codex-auth login [name] --device-auth
# force overwrite when reusing a name across different detected identities
codex-auth login [name] --force
# save the current logged-in token as a named account
codex-auth save <name>
# force overwrite a name even when it currently maps to a different email
codex-auth save <name> --force
# switch active account
codex-auth use <name>
# or pick interactively
codex-auth use
# list accounts
codex-auth list
# list accounts with mapping metadata (email/account/user/usage)
codex-auth list --details
# show current account name
codex-auth current
# check for a newer release and update globally
codex-auth self-update
# check only (no install)
codex-auth self-update --check
# reinstall latest even if already up to date
codex-auth self-update --reinstall
# remove accounts (interactive multi-select)
codex-auth remove
# remove by selector or all
codex-auth remove <query>
codex-auth remove --all
# show auto-switch + service status
codex-auth status
# auto-switch configuration
codex-auth config auto enable
codex-auth config auto disable
codex-auth config auto --5h 12 --weekly 8
# usage source configuration
codex-auth config api enable
codex-auth config api disable
# daemon runtime (internal/service use)
codex-auth daemon --once
codex-auth daemon --watch
# optional shell hook helpers
codex-auth setup-login-hook
codex-auth hook-status
codex-auth remove-login-hook
codex-auth save <name> [--force] – Validates <name>, ensures auth.json exists, then snapshots it to ~/.codex/accounts/<name>.json. By default, it blocks overwriting a name when the existing snapshot email differs from current auth. If name is omitted, it first tries reusing the active snapshot name when identity matches; otherwise it infers one from auth email.codex-auth login [name] [--device-auth] [--force] – Runs codex login (optionally with device auth), waits for refreshed auth snapshot detection, then saves it. If name is omitted, it always infers one from auth email with unique-suffix handling for multi-workspace identities.codex-auth use [name] – Accepts a name or launches an interactive selector with the current account pre-selected, writes ~/.codex/auth.json as a regular file from the chosen snapshot, and records the active name.codex-auth list [--details] – Lists all saved snapshots alphabetically and marks the active one with *. --details adds per-snapshot mapping metadata (email, account id, user id, and usage metadata) for easier session/account troubleshooting.codex-auth current – Prints the active account name, or a friendly message if none is active.codex-auth self-update [--check] [--reinstall] [-y] – Checks npm for newer release metadata. --check prints current/latest/status only. --reinstall forces reinstall even when already up to date. -y skips confirmation prompts.codex-auth remove [query|--all] – Removes snapshots interactively or by selector. If the active account is removed, the best remaining account is activated automatically.codex-auth status – Prints auto-switch state, managed service status, active thresholds, and usage mode.codex-auth config auto ... – Enables/disables managed auto-switch and updates threshold percentages.codex-auth config api enable|disable – Chooses usage source mode (api or local).codex-auth daemon --once|--watch – Runs the auto-switch loop once or continuously.codex-auth setup-login-hook [-f <path>] – Installs or refreshes an optional shell hook in your rc file to restore session-pinned snapshot before each codex run, refresh codex-auth session memory after each codex exit, and restore common terminal modes before returning to your prompt.codex-auth hook-status [-f <path>] – Shows whether the optional login auto-snapshot hook is installed for the selected rc file.codex-auth remove-login-hook [-f <path>] – Removes the optional shell hook.When auto-switch is enabled, the daemon evaluates the active account and switches when either threshold is crossed:
5h remaining < threshold5h (default 10%)weekly remaining < thresholdWeekly (default 5%)Usage refresh is hybrid:
config api enable): query ChatGPT usage endpoint for each account.codex-auth config auto enable installs a managed watcher per OS:
systemd servicecodex-auth status reports whether the managed watcher is active.
Notes:
codex-auth shows the help screen and also displays an update notice when a newer npm release is available.codex-auth now prompts to install updates immediately when a newer npm release is available ([Y/n], Enter defaults to yes).FAQs
A command-line tool that lets you manage and switch between multiple Codex accounts instantly, no more constant logins and logouts.
The npm package @imdeadpool/codex-account-switcher receives a total of 0 weekly downloads. As such, @imdeadpool/codex-account-switcher popularity was classified as not popular.
We found that @imdeadpool/codex-account-switcher demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Security News
Agent Baseline’s new reference architecture shows how to secure software factories with four boundaries enforced outside the AI agent.
Security News
arXiv now limits authors to two submissions a month as AI slop overwhelms moderators, delays good papers, and sparks debate over applying the limit to everyone.
Research
/Security News
A new GhostAction wave hits hundreds of GitHub repos, expanding CI/CD secret theft to cloud and AI credentials in source code and git history.