prodex

prodex is a CLI wrapper for codex that separates multiple profiles by giving each one its own CODEX_HOME.

Install from crates.io:

cargo install prodex

For the shorter version, see QUICKSTART.md.

In short:

• one prodex profile = one CODEX_HOME directory
• login is still handled by codex
• prodex manages profiles, the active profile, built-in quota checks, and launching codex

The mental model is similar to browser profiles, but for codex.

Quick Start

1. Install

cargo install prodex

Package page:

https://crates.io/crates/prodex

2. Import your current codex profile

If you already have an active login in ~/.codex:

prodex profile import-current main

This will:

• copy ~/.codex into a new managed profile
• store the profile in ~/.prodex/profiles/main
• set main as the active profile

3. Log in and let prodex create the profile

If you want a fresh login, prodex can create or reuse a profile automatically from the account email:

prodex login

This will:

• run codex login in a temporary isolated CODEX_HOME
• resolve the logged-in account email from the ChatGPT id_token stored in auth.json
• create a managed profile whose name is derived from that email
• reuse the existing profile instead of creating a duplicate when that email is already registered
• switch the active profile to the reused or newly created profile

If the email-derived profile name is already taken by a different account, prodex keeps the email uniqueness rule and creates a suffixed name such as main_example.com-2.

If you want to target a specific existing profile name instead:

prodex profile add second
prodex login --profile second

Use prodex login --profile <name> when you want a fixed profile name, or when you are not using the ChatGPT login flow that writes an email-bearing id_token.

prodex login still delegates the actual authentication flow to codex.

4. View all quotas

prodex quota --all

Example MAIN column:

5h 63% left | weekly 88% left

5. Select the active profile and run codex

prodex use main
prodex run

Or run directly with a specific profile:

prodex run --profile second

Requirements

prodex relies on the following binaries:

• codex

Quick check:

codex --help

If you want to audit the prodex environment:

prodex doctor
prodex doctor --quota

How It Works

prodex stores its own state in:

~/.prodex

The main structure is:

• state.json: the list of profiles and the active profile
• profiles/<name>: the managed CODEX_HOME for each profile

Authentication is still stored by codex inside each profile's auth.json.

Most Common Commands

Profile Management

Install from crates.io:

cargo install prodex

Add an empty profile:

prodex profile add work

Import from ~/.codex:

prodex profile import-current work

List all profiles:

prodex profile list

Select the active profile:

prodex use work

Remove a profile:

prodex profile remove work

Remove a profile and its managed home:

prodex profile remove work --delete-home

Login/Logout

Log in and auto-create or reuse a unique profile based on the email you use:

prodex login

This only works when the login flow writes a ChatGPT id_token with an email claim into auth.json.

Log in to a specific profile:

prodex login --profile work

Log out from a specific profile:

prodex logout --profile work

Quota

Show quota for one profile:

prodex quota --profile work

Show raw quota JSON:

prodex quota --profile work --raw

View all profiles at once:

prodex quota --all

Run codex

Run codex with the active profile:

prodex run

Run codex with arguments:

prodex run -- --version
prodex run exec "review this repo"

Run with a specific profile:

prodex run --profile work

Temporarily disable auto-rotate:

prodex run --profile work --no-auto-rotate

Skip quota preflight:

prodex run --profile work --skip-quota-check

Quota Behavior

Before prodex run launches codex, prodex tries to check quota for the selected profile.

Before a profile is considered safe to use, prodex requires both the 5h and weekly quota windows to be present and still below 100/100.

If that profile does not clearly have remaining required quota:

• prodex run tries to rotate to the next ready profile by default, including when you pass --profile
• if you want the command to stay blocked on that profile instead, use --no-auto-rotate
• it prints the missing, unknown, or exhausted quota reasons
• it suggests other profiles that appear ready, when available

If auto-rotate succeeds, the active profile is updated to the profile that was used.

Important Notes

• quota checks are built into prodex and use the ChatGPT backend endpoint used by Codex
• ChatGPT quota can only be read when the profile uses ChatGPT auth, not an API key
• prodex login without --profile depends on being able to read the ChatGPT account email from tokens.id_token in auth.json
• if a profile uses API key auth, quota --all will show error for that profile
• prodex does not replace codex; it only acts as a launcher and profile manager

Environment Variables

Override the prodex state location:

PRODEX_HOME=/path/to/prodex-home

Override the codex binary:

PRODEX_CODEX_BIN=/path/to/codex

Override the default ChatGPT quota base URL:

CODEX_CHATGPT_BASE_URL=https://chatgpt.com/backend-api

Development

Run during development:

cargo run -- profile list
cargo run -- quota --all
cargo run -- doctor

Tests:

cargo test