prodex

prodex is a wrapper for Codex and Claude Code for working with multiple profiles.

The main feature is auto rotate. If one OpenAI/Codex profile runs out of quota, prodex can route new work to another profile that is still available. You do not need to switch accounts manually.

It also keeps profiles isolated and keeps existing sessions attached to the profile they started with.

Why use it

Use prodex if you want to:

• automatically use another available profile when quota runs out
• work with multiple accounts
• keep each profile isolated
• keep sessions tied to the original profile

If you only use one account and do not need profile isolation or quota-aware routing, you probably do not need it.

Requirements

You need at least one logged-in Prodex profile.

Depending on your setup, you may also need:

• Codex CLI for prodex and prodex caveman
• Claude Code for prodex claude
• claude-mem for mem variants

Install

npm

npm install -g @christiandoxa/prodex

Cargo

cargo install prodex

If you install with Cargo, make sure the codex binary in your PATH is already installed and up to date.

Quick start

If your current Codex home is already logged in:

prodex profile import-current main

Or set it up from scratch:

prodex login
prodex profile add second
prodex login --profile second

You can also import a logged-in Copilot CLI account:

prodex profile import copilot
prodex profile import copilot --name copilot-main --activate

Check your profiles and quota:

prodex profile list
prodex quota --all

Run through prodex:

prodex
prodex caveman
prodex caveman mem
prodex exec "review this repo"
prodex claude -- -p "summarize this repo"
prodex claude mem -- -p "recall past work on this repo"

Common commands

Run Codex

prodex
prodex run
prodex run --profile main
prodex exec "review this repo"
prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
printf 'context from stdin' | prodex run exec "summarize this"

Run Caveman mode

prodex caveman
prodex caveman mem
prodex caveman --profile main
prodex caveman exec "review this repo in caveman mode"
prodex caveman 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9

prodex caveman runs Codex with a temporary overlay CODEX_HOME, so the base profile home stays unchanged after the session ends.

If you use the mem variant, Prodex points an existing Claude-Mem Codex setup to the active Prodex session path instead of the default ~/.codex/sessions.

Run Claude Code

prodex claude -- -p "summarize this repo"
prodex claude mem -- -p "recall past work on this repo"
prodex claude caveman
prodex claude caveman mem
prodex claude caveman -- -p "summarize this repo briefly"
prodex claude caveman mem -- -p "summarize this repo briefly"
prodex claude --profile second caveman -- -p "review the latest diff briefly"
prodex claude --profile second -- -p --output-format json "show the latest diff"

prodex claude uses the normal Claude Code flow.

prodex claude caveman enables Caveman for that session while keeping state under the Prodex-managed CLAUDE_CONFIG_DIR, not the global ~/.claude.

prodex claude caveman mem combines Caveman and Claude-Mem.

Profile commands

prodex profile list
prodex profile add second
prodex profile import copilot
prodex profile import-current main
prodex login --profile second
prodex use --profile main
prodex logout --profile main
prodex profile remove second
prodex profile remove --all

Notes

Auto rotate and quota checks apply to supported OpenAI/Codex profiles.

If a profile's config.toml sets model_provider to a non-OpenAI backend such as amazon-bedrock, prodex run and prodex caveman launch directly without quota preflight or the local auto-rotate proxy.

prodex quota is not available for those profiles.

prodex claude is only supported with the default OpenAI/Codex provider.

When you import a Copilot profile, Prodex does not move the Copilot token into Prodex-managed storage. It only records the provider identity and API endpoint in its own metadata.

Utility commands

prodex profile export
prodex quota --all
prodex quota --all --once
prodex doctor --runtime

More

See QUICKSTART.md for a longer walkthrough.