Codex Auth (local-only)

This project provides a single Zig tool: codex-auth, a local-only ChatGPT account manager for Codex.

• It never calls OpenAI APIs, so it does not affect your OpenAI account security through remote API requests.
• All data is read locally from Codex files under ~/.codex (including sessions/ and related auth files).

Full Commands

codex-auth list # list all accounts
codex-auth add [--no-login] # add current account (runs `codex login` by default)
codex-auth switch # switch active account (interactive)
codex-auth import <path> [--name <name>] # smart import: file -> single import, folder -> batch import
codex-auth remove # remove accounts (interactive multi-select)

Examples

List accounts (default table with borders):

codex-auth list

Add the currently logged-in Codex account:

codex-auth add

Import an auth.json backup:

codex-auth import /path/to/auth.json --name personal

Batch import from a folder:

codex-auth import /path/to/auth-exports

Switch accounts (interactive list shows email, 5h, weekly, last activity):

codex-auth switch               # arrow + number input

Remove accounts (interactive multi-select):

codex-auth remove

Install

• Linux/macOS/WSL2 (one-line, latest release):

curl -fsSL https://raw.githubusercontent.com/loongphy/codex-auth/main/scripts/install.sh | bash

• Windows (PowerShell, one-line, latest release):

irm https://raw.githubusercontent.com/loongphy/codex-auth/main/scripts/install.ps1 | iex