Codex Profiles CLI
A CLI that saves Codex accounts under labels and switches between them with one command, skipping repeated codex login.
- 94 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Keeps copies of `auth.json` with Codex login tokens on disk.
- The exported JSON bundle holds credentials, and `status` may send the access token to a usage endpoint.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/codex-profilesDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Keeps copies of `auth.json` with Codex login tokens on disk.
- The exported JSON bundle holds credentials, and `status` may send the access token to a usage endpoint.
This is third-party code. Review the repository files before installing.
What it does
Codex Profiles keeps copies of `auth.json` under names and swaps the right one in on demand. `save --label work` remembers the current login and `load --label work` restores it. `list` shows saved profiles, and `status --all --compact` prints remaining limits and reset times per account. It also offers JSON bundle export and import, a `doctor` diagnostic with `--fix`, label rename and clear, and deletion by label or id. Data lives under `$CODEX_HOME/profiles/` or `~/.codex/profiles/`. The native `codex --profile` selects a configuration layer and does not switch accounts.
Who it is for. Codex CLI users with personal and work accounts who are tired of logging in again and again.
Good fit when
- Personal and work Codex accounts are swapped several times a day.
- Remaining limits across all of your accounts must be checked before a task starts.
- Profiles must be moved to another machine through a JSON bundle.
- The profile store looks damaged and should be checked with `doctor`.
Not a fit when
- Only model settings and modes need to change; the native `codex --profile` does that.
- Keeping copies of login tokens on disk is not acceptable.
- Codex is mid-task right now; active sessions should finish before switching.
Example request
Save the current Codex login as work and show remaining limits for every saved account.Limitations
Finish active work and restart the affected client before switching. For OAuth profiles, `status` may send the access token to an allowed usage endpoint and refresh it through OpenAI. API-key profiles show usage as unavailable. Export bundles contain credentials and must be treated like passwords. Import refuses to replace an existing file and rolls back on failure, but the rollback is not a filesystem transaction: keep other processes away from the store during import.
How to disable. Remove the package with `npm uninstall -g codex-profiles`. Delete the `~/.codex/profiles/` directory with saved logins separately.
FAQ
How do I switch Codex accounts without logging in again?
Save the login with `codex-profiles save --label work`, then return to it with `codex-profiles load --label work`. Without a label a profile picker opens.
How does it differ from `codex --profile`?
The native flag selects a configuration layer. Codex Profiles swaps the account itself, meaning the saved copy of `auth.json`.
Is `auth.json` uploaded to an outside service?
Profiles stay on the machine. The one exception is `status` for OAuth profiles, which may send the access token to an allowed usage endpoint.
How do I verify the installation?
Run `codex-profiles --version` and `codex-profiles list`.
How do I delete a profile?
Run `codex-profiles delete --label work`. The `--yes` flag skips confirmation, and without a label a profile picker opens.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI for reversible instruction deployment into Codex: preview the plan, confirm, and fully roll back
Codex Settings skills
Codex CLI Skills & Profiles
A Codex CLI plugin with twelve skills: deep research, pull request review, image generation and session handoff
Codex Trace reads local Codex CLI logs and shows turns, tool calls and token usage in a desktop window or in the browser.
An unofficial Codex CLI build with rewind: /rewind returns the conversation and project files to a chosen prompt, /redo undoes it.
Codex Bridge sends questions and file analysis from Claude Code, Cursor and VS Code to the official Codex CLI via Python MCP.
A kit for porting a Claude Code workflow to OpenAI Codex CLI for multi-tenant PHP/Bitrix24-Marketplace projects
README in short
Three install routes, a quick start, a command table, data locations and rollback behaviour on a failed import are described. The FAQ covers uninstalling, login storage and installation checks.