Codex Profiles

Manage multiple Codex CLI profiles and switch between them instantly.

Overview • Install • Uninstall • Usage • FAQ

Overview

Codex Profiles helps you manage multiple Codex CLI logins on a single machine. It saves the current login and lets you switch in seconds, making it ideal for personal and team accounts across multiple organizations.

Install

[!IMPORTANT] Requires Codex CLI (with ChatGPT subscription or OpenAI API key).

[!TIP] Looking for a Teams promo? See details

NPM

npm install -g codex-profiles

Bun

bun install -g codex-profiles

Manual Install

Automatically detects your OS/architecture, downloads the correct binary, verifies checksums:

curl -fsSL https://raw.githubusercontent.com/midhunmonachan/codex-profiles/main/install.sh | bash

Uninstall

[!WARNING] Legacy script support is ending. Remove cx and use this version instead.

rm ~/.local/bin/cx

If you installed with a custom command name (mycmd), remove that name instead:

rm ~/.local/bin/mycmd

NPM

npm uninstall -g codex-profiles

Bun

bun uninstall -g codex-profiles

Manual Uninstall

rm ~/.local/bin/codex-profiles

Usage

[!TIP] Commands are interactive unless you pass --label.

[!WARNING] Deleting a profile does not log you out. It only removes the saved profile file.

Quick example:

$ codex-profiles save --label team
Saved profile mail@company.com (Team)

$ codex-profiles load --label team
Loaded profile mail@company.com (Team)

[!NOTE] Files are stored under ~/.codex/profiles/:

File	Purpose
{email-plan}.json	Saved profiles.
profiles.json	Profile metadata (labels, last-used, active).
profiles.lock	Lock file for safe updates.

FAQ