prodex

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

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, quota checks via cq, and launching codex

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

Quick Start

1. Build

cargo build --release

The binary will be available at:

./target/release/prodex

2. Import your current codex profile

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

./target/release/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. Add a new profile and log in

If you want a fresh empty profile:

./target/release/prodex profile add second
./target/release/prodex login --profile second

prodex login does not handle the OAuth callback itself. It only runs codex login with the selected profile's CODEX_HOME.

4. View all quotas

./target/release/prodex quota --all

Example MAIN column:

5h 37/100 used | weekly 12/100 used

5. Select the active profile and run codex

./target/release/prodex use main
./target/release/prodex run

Or run directly with a specific profile:

./target/release/prodex run --profile second

Requirements

prodex relies on the following binaries:

• codex
• cq

Quick check:

codex --help
cq --help

If you want to audit the prodex environment:

./target/release/prodex doctor
./target/release/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

Add an empty profile:

./target/release/prodex profile add work

Import from ~/.codex:

./target/release/prodex profile import-current work

List all profiles:

./target/release/prodex profile list

Select the active profile:

./target/release/prodex use work

Remove a profile:

./target/release/prodex profile remove work

Remove a profile and its managed home:

./target/release/prodex profile remove work --delete-home

Login/Logout

Log in to a specific profile:

./target/release/prodex login --profile work

Log out from a specific profile:

./target/release/prodex logout --profile work

Quota

Show quota for one profile:

./target/release/prodex quota --profile work

Show raw quota JSON:

./target/release/prodex quota --profile work --raw

View all profiles at once:

./target/release/prodex quota --all

Run codex

Run codex with the active profile:

./target/release/prodex run

Run codex with arguments:

./target/release/prodex run -- --version
./target/release/prodex run exec "review this repo"

Run with a specific profile:

./target/release/prodex run --profile work

Temporarily disable auto-rotate:

./target/release/prodex run --profile work --no-auto-rotate

Skip quota preflight:

./target/release/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 --all and quota preflight depend on cq
• ChatGPT quota can only be read when the profile uses ChatGPT auth, not an API key
• 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 cq binary:

PRODEX_CQ_BIN=/path/to/cq

Development

Run during development:

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

Tests:

cargo test