codex-su

Switch between multiple Codex accounts.

If you only use one account, you probably do not need this. If you bounce between work and personal, this is faster.

Install

npm install -g codex-su

codex-su expects the codex CLI to already exist on your machine.

Quick Start

Start here:

# You will be prompted to save the current session or log in with a new one.
codex-su add
# See your current account
codex-su whoami
codex-su use <name>

Commands

codex-su add <name> [--current | --login]
codex-su list
codex-su whoami
codex-su use <name> [--yes]
codex-su remove <name> [--yes]
codex-su version

How It Works

• add --current saves the current Codex session as a named profile.
• add --login runs codex login, then saves that session as a named profile.
• use swaps the active Codex auth file to the saved profile you picked.
• list shows saved profiles and marks the current one.
• whoami shows whether the current session matches a saved profile or is unsaved.
• remove deletes a saved profile, unless it is the one currently active.

Interactive shells get prompts for the annoying cases, like replacing an existing profile or switching away from an unsaved session. In non-interactive flows, the CLI stays stricter on purpose.

Example Flow

# save your current account
codex-su add work --current

# log into another account and save it
codex-su add personal --login

# check what you have
codex-su list

# switch back to work
codex-su use work

# confirm the active session
codex-su whoami

Development

From the repo root:

pnpm install
pnpm --filter codex-su build
pnpm --filter codex-su test
pnpm --filter codex-su cli --help

Run the built CLI:

pnpm --filter codex-su start -- list
pnpm --filter codex-su start -- add work --current

Release Check

pnpm --filter codex-su release:check

Publish

Publish from apps/cli, not from the repo root.

npm publish --access public