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
• Prodex-owned screens use a fixed 110-character layout with section headers, wrapped fields, and readable tables

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

prodex quota --all prints a Quota Overview table with a fixed-width layout. The main quota summary now appears in the REMAINING column, and each profile gets a wrapped status: detail line underneath the row.

Example REMAINING value:

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

This renders a Profiles panel with wrapped fields and one panel per profile.

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

This renders a Quota Overview table with PROFILE, CUR, AUTH, ACCOUNT, PLAN, and REMAINING, plus a status: line for each profile.

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 have remaining capacity.

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
• profile list, current, doctor, login, quota, and other Prodex-owned screens use the same 110-character layout
• 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