codex-profiles
VerifiedSwitch between isolated Codex accounts without token hassle.
What is codex-profiles?
codex-profiles wraps Codex's built-in CODEX_HOME feature into simple commands. Each profile maintains its own directory containing authentication, settings, plugins, connectors, and logs so nothing leaks between contexts.
Instead of copying auth files or manually setting environment variables, the tool launches Codex CLI or Desktop instances with the chosen profile. This approach preserves full state isolation while making account switching fast and repeatable.
It targets developers and power users who maintain multiple Codex accounts for different purposes such as school, personal projects, or client work and need clean boundaries between them.
Capabilities
What you can build with codex-profiles
Separate work and personal accounts
Run one profile for client projects with specific connectors and another for personal tasks without mixing sessions or caches.
Parallel Desktop instances
Launch two Codex Desktop windows side by side, each tied to its own profile and local data for comparing outputs or handling different limits.
School account with higher limits
Quickly switch to an education profile for heavy coding sessions while keeping daily automation tools in the personal profile.
Install codex-profiles
npm install -g codex-profilenpm install -g codex-profile- 1Install via npm with the codex-profile package.
- 2Create a new profile directory using the provided wrapper command.
- 3Launch the CLI with a chosen profile name and optional command.
- 4Start a Desktop instance bound to a specific profile and app path.
- 5Verify isolation by checking that each profile keeps its own auth and logs.
Works with
codex-profiles: pros & cons
Pros
- +Provides true isolation by using separate CODEX_HOME directories rather than swapping tokens.
- +Supports both CLI and experimental parallel Desktop usage.
- +Lightweight Bash wrapper that avoids manual environment variable management.
- +Includes documentation and GEO-optimized site for better discoverability.
Cons
- –Desktop parallel mode is still experimental and requires extra setup.
- –Limited to macOS and Linux platforms.
- –Requires manual profile creation before first use.
Frequently asked questions
It isolates the entire Codex home directory instead of only moving the token file, keeping sessions, plugins, and caches separate.
User reviews
Verified reviews from the community shape this listing's rating.
Loading reviews…
Similar agents
Other automation options worth comparing.
