cxprof 0.1.1

Launch Codex CLI with isolated local account profiles
cxprof-0.1.1 is not a library.

cxprof

crates.io CI

Rust CLI for using multiple local Codex accounts without logging one account out to use another. Each named profile is a complete, isolated CODEX_HOME

Install

cargo install cxprof

Prebuilt binaries for Linux, macOS, and Windows are also attached to each GitHub release.

To uninstall the binary, run cargo uninstall cxprof. Cargo does not remove profile data; remove each profile explicitly before uninstalling if you no longer need its Codex state.

Quick start

# Create a private Codex home and authenticate it once.
cxprof create work
cxprof login work

# Start interactive Codex with that account.
cxprof run work

# Or forward any Codex command and arguments unchanged.
cxprof run work -- exec "review this repository"

Create another profile the same way. Processes using different profiles can run concurrently because each child receives a different CODEX_HOME.

Commands

cxprof create <name>
cxprof list [--check]
cxprof path <name>
cxprof login <name> [--device-auth]
cxprof status <name>
cxprof run <name> [--] [codex arguments...]
cxprof doctor [name]
cxprof remove <name> [--yes]
  • create accepts portable names containing 1–64 ASCII letters, digits, underscores, or hyphens. The first character must be alphanumeric.
  • list reads only switcher-owned metadata. list --check delegates each authentication check to Codex.
  • login, status, and run inherit the terminal, working directory, and environment. Only CODEX_HOME is replaced.
  • run returns the Codex process's exit code. On Unix it replaces the switcher process so signals and terminal control go directly to Codex.
  • remove requires an interactive confirmation unless --yes is supplied and refuses directories without a valid ownership marker.

Use --codex-bin PATH to choose a specific Codex executable and --root PATH to override profile storage. Both are global options and can appear before a subcommand.

Storage and security

Profiles are stored under:

  • macOS: ~/Library/Application Support/codex-profile-switcher/profiles
  • Linux: $XDG_STATE_HOME/codex-profile-switcher/profiles, or ~/.local/state/codex-profile-switcher/profiles
  • Windows: %LOCALAPPDATA%\codex-profile-switcher\profiles

Every profile contains an ownership marker and this Codex setting:

cli_auth_credentials_store = "file"

Official OpenAI documentation says file-backed credentials are stored in auth.json under CODEX_HOME. The switcher creates the containing profile but never opens, parses, copies, prints, or deletes an individual credential file; authentication remains entirely owned by Codex.

On a managed company device, an administrator can override the credential store. Codex remains responsible for enforcing that policy; if it forces a shared keyring, isolated account homes are not available on that device.

On Unix, profile directories use mode 0700 and tool-owned files use 0600. On Windows, new profiles inherit the current user's %LOCALAPPDATA% ACL; doctor reports this platform limitation.

See SECURITY.md for the complete security boundary. Treat every profile's auth.json as a password: never commit or share it.

References