Introduction
# Codex Account Switcher
Manage multiple OpenAI Codex identities (e.g. personal vs. work) by swapping the authentication token file.
## Usage
### 1. List Accounts Show saved accounts (active one is marked with `ACTIVE` on the right). Default output is compact.
- `--verbose` includes refresh age + token TTL (debug) - `--json` outputs the verbose info as JSON ```bash ./codex-accounts.py list ```
To include emails/diagnostics: ```bash ./codex-accounts.py list --verbose ```
### 2. Add an Account Interactive wizard to capture login(s).
- **Always starts a fresh browser login** (`codex logout && codex login`) so you explicitly choose the identity to capture. - After each login it saves a snapshot. - In an interactive terminal it asks if you want to add another. - When invoked non-interactively (e.g. via Moltbot), it runs **single-shot** (no "add another" prompt). - When naming an account, **press Enter** to accept the default name (local-part of the detected email, e.g. `oliver` from `oliver@…`).
```bash ./codex-accounts.py add ```
### 3. Switch Account Instantly swap the active login. ```bash ./codex-accounts.py use work ```
### 4. Auto-Switch to Best Quota Check all accounts and switch to the one with most weekly quota available. ```bash ./codex-accounts.py auto ./codex-accounts.py auto --json ```
Output: ``` 🔄 Checking quota for 2 account(s)...
→ sylvia... weekly 27% used → oliver... weekly 100% used
✅ Switched to: sylvia Weekly quota: 27% used (73% available)
All accounts: sylvia: 27% weekly ← oliver: 100% weekly ```
## Setup
See [SETUP.md](SETUP.md) for prerequisites and setup instructions.