____ ___  ____  _______  ____        ___   _  ___
  / ___/ _ \|  _ \| ____\ \/ /\ \      / / | | |/ _ \
 | |  | | | | | | |  _|  \  /  \ \ /\ / /| |_| | | | |
 | |__| |_| | |_| | |___ /  \   \ V  V / |  _  | |_| |
  \____\___/|____/|_____/_/\_\   \_/\_/  |_| |_|\___/

codexwho

Manage multiple Codex CLI account configurations easily. Switch between work and personal accounts, or maintain separate configurations for different projects.

Sibling project of claudewho, which does the same for Claude Code.

Installation

Homebrew (recommended)

brew install cliq/tap/codexwho

Or:

brew tap cliq/tap
brew install codexwho

Manual

git clone https://github.com/cliq/codexwho.git
cd codexwho
chmod +x bin/codexwho
sudo ln -s "$(pwd)/bin/codexwho" /usr/local/bin/codexwho

Usage

Create accounts

codexwho add work
codexwho add personal
codexwho add client-project

Migrate settings from ~/.codex

Copy your existing Codex configuration to a new account:

# During account creation
codexwho add work --migrate

# Or after creating an account
codexwho migrate work

This copies config.toml, AGENTS.md, and your prompts/, rules/, skills/, and plugins/ directories. Credentials (auth.json), sessions, and history are not copied — each account logs in separately. Running it again on the same account is safe — existing items are skipped.

List accounts

codexwho list

Output:

Configured Codex accounts:

  work                 ~/.codexwho-work              (authenticated)
  personal             ~/.codexwho-personal          (not authenticated)
  client-project       ~/.codexwho-client-project    (authenticated)

Switch with codexwho use <name>

Launch Codex with an account

# Using the wrapper command (recommended)
codexwho-work
codexwho-personal

# Or switch the default account
codexwho use work
codex

Remove an account

codexwho remove personal

This will prompt for confirmation before deleting the account directory.

Commands

Command	Description
list	List all configured accounts
add <name>	Create a new account configuration
migrate <name>	Migrate settings from ~/.codex
remove <name>	Remove an account (with confirmation)
use <name>	Switch to the specified account
shell-init	Print shell aliases for sourcing
version	Show version information
help	Show help message

How it works

• Each account is stored in ~/.codexwho-<name>/
• Account names are tracked in ~/.codexwho.conf
• Wrapper scripts like codexwho-work are created in ~/.local/bin/ and set CODEX_HOME before launching Codex
• Your original ~/.codex directory is never modified

Requirements

• Codex CLI installed (npm install -g @openai/codex or brew install codex)
• Bash 3.2+ or Zsh
• macOS or Linux

Notes

• Each account requires a separate OpenAI account (different email)
• Each account has its own usage limits
• Check OpenAI's terms of use to ensure compliance

License

MIT