codex-auth

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.

How it Works

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.

Requirements

• Node.js 18 or newer

Install (npm)

npm i -g codex-auth

Usage

# save the current logged-in token as a named account
codex-auth save <name>

# switch active account (symlinks on macOS/Linux; copies on Windows)
codex-auth use <name>

# or pick interactively
codex-auth use

# list accounts
codex-auth list

# show current account name
codex-auth current

Command reference

• codex-auth save <name> – Validates <name>, ensures auth.json exists, then snapshots it to ~/.codex/accounts/<name>.json.
• codex-auth use [name] – Accepts a name or launches an interactive selector with the current account pre-selected. Copies on Windows, creates a symlink elsewhere, and records the active name.
• codex-auth list – Lists all saved snapshots alphabetically and marks the active one with *.
• codex-auth current – Prints the active account name, or a friendly message if none is active.

Notes:

• Works on macOS/Linux (symlink) and Windows (copy).
• Requires Node 18+.