codex-profiles is a small open-source Bash CLI for developers who use Codex CLI or Codex Desktop across multiple accounts. It launches Codex with a named CODEX_HOME so each profile keeps its own auth, config, sessions, plugins, connector state, caches, and logs. The point is simple: switch between personal, work, school, team, and client Codex contexts without copying auth.json token files or mixing local Desktop state.

I built it for a real multi-account workflow: a shared/team account for team setup, a personal account with connector access for outreach and testing, and a school account for heavier coding sessions. With one default Codex home, third-party connectors, plugins, sessions, and Desktop state get mixed together. codex-profile makes the clean boundary easy to use.

Quick start:

Install with npm:

npm install -g codex-profile

Or install with Homebrew:

brew install Ducksss/tap/codex-profile

Create and log in to profiles once:

codex-profile init personal

codex-profile init work

codex-profile login personal

codex-profile login work

Run Codex CLI with the right profile:

codex-profile cli personal

codex-profile cli work exec "run tests and summarize failures"

Run Codex Desktop on macOS:

codex-profile app personal ~/Dev/my-project

codex-profile app work

Run experimental parallel Desktop instances:

codex-profile app-instance personal ~/Dev/project-a

codex-profile app-instance work --rebuild ~/Dev/project-b

Useful for:

- keeping work, personal, school, and client Codex accounts separate

- preserving account-specific connectors and plugins

- testing Codex config changes without polluting the default profile

- opening separate Codex Desktop instances side by side on macOS

- checking profile health with codex-profile list, status, and doctor

The tool is MIT-licensed, dependency-free, and tested for CLI workflows on macOS and Linux. It does not read, parse, print, copy, or migrate Codex auth tokens. It only sets CODEX_HOME before launching Codex.

Boundary note: codex-profiles isolates Codex local state under CODEX_HOME, not the whole operating system. SSH keys, GitHub CLI auth, cloud CLI credentials, browser cookies, OS keychain items, npm state, and git credentials are still shared by the same OS user.