prodex 0.2.103

Safe multi-account auto-rotate for Codex CLI with isolated CODEX_HOME profiles
prodex-0.2.103 is not a library.
Visit the last successful build: prodex-0.20.0

prodex

Safe multi-account auto-rotate for codex.

prodex wraps codex with isolated profiles, built-in quota checks, and seamless account rotation.

Why prodex

  • auto-rotate to another ready account when the current one is quota-blocked or temporarily unhealthy
  • keep each account isolated in its own CODEX_HOME
  • preserve continuation affinity so ongoing chains stay on the right account
  • keep transport behavior close to direct codex

Install

Install from npm:

npm install -g @christiandoxa/prodex

This is usually the lightest option because it does not need a local Rust build.

Or install from crates.io:

cargo install prodex

The npm package version is kept in lockstep with the published crate version.

Update Tips

Check your installed version first:

prodex --version

The current local binary version in this repo is 0.2.103, so matching update commands look like this:

npm install -g @christiandoxa/prodex@0.2.103
cargo install prodex --force --version 0.2.103

If you just want the lighter install path, prefer npm over cargo install because npm does not need to compile prodex locally.

If you want to move from a Cargo-installed binary to npm, uninstall the Cargo binary first and then install the npm package:

cargo uninstall prodex
npm install -g @christiandoxa/prodex

Quick Start

Import your current codex login:

prodex profile import-current main

Or create a profile through codex login:

prodex login

If you need device-code auth, pass it through unchanged:

prodex login --device-auth

Check quotas:

prodex quota --all
prodex info

Run codex with safe auto-rotate:

prodex
prodex run

Running prodex without a subcommand is shorthand for prodex run.

Resume a saved Codex session directly:

prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9

Pin a specific profile when needed:

prodex run --profile second

prodex run exec also preserves stdin passthrough, so prompt and piped input stay together:

printf 'context from stdin' | prodex run exec "summarize this"

Core Commands

prodex
prodex exec "review this repo"
prodex profile list
prodex use --profile main
prodex info
prodex quota --all
prodex quota --all --once
prodex doctor
prodex doctor --runtime
prodex run
prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9

Notes

  • one prodex profile = one isolated CODEX_HOME
  • prodex login still uses the real codex login flow, including --device-auth
  • prodex login without --profile first tries to read the ChatGPT account email from tokens.id_token in auth.json, then falls back to the usage endpoint email when needed
  • prodex without a subcommand behaves like prodex run
  • prodex run <session-id> forwards to codex resume <session-id>
  • prodex info summarizes profile count, the installed prodex version and update status, running Prodex processes, aggregated quota pool, and a no-reset runway estimate from active runtime logs
  • prodex quota live-refreshes every 5 seconds by default, and prodex quota --all also shows aggregated 5h and weekly pool remaining before the per-profile table
  • Prodex-owned screens adapt to terminal width, and live views can also adapt to terminal height

For a slightly longer setup guide, see QUICKSTART.md.