@christiandoxa/prodex 0.2.106 → 0.2.108

package/README.md

@@ -1,15 +1,25 @@
 # prodex
 
-Safe multi-account auto-rotate for `codex`.
+[![CI](https://github.com/christiandoxa/prodex/actions/workflows/ci.yml/badge.svg)](https://github.com/christiandoxa/prodex/actions/workflows/ci.yml)
 
-`prodex` wraps `codex` with isolated profiles, built-in quota checks, and seamless account rotation.
+One OpenAI profile pool for Codex CLI and Claude Code.
 
-## Why prodex
+`prodex` gives you two entry points backed by the same OpenAI account pool:
 
-- 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`
+| Use case | Command |
+| --- | --- |
+| Run Codex CLI through Prodex | `prodex` or `prodex run` |
+| Run Claude Code through Prodex | `prodex claude` |
+
+It keeps each profile isolated, checks quota before launch, and rotates to another ready account before a request or stream is committed.
+
+## Requirements
+
+- An OpenAI account, plus at least one logged-in Prodex profile
+- Codex CLI if you want to use `prodex`
+- Claude Code (`claude`) if you want to use `prodex claude`
+
+If you install `@christiandoxa/prodex` from npm, the Codex runtime dependency is installed for you. Claude Code is still a separate CLI and should already be available on your `PATH` when you use `prodex claude`.
 
 ## Install
 
@@ -19,8 +29,6 @@ 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](https://crates.io/crates/prodex):
 
 ```bash
@@ -29,109 +37,99 @@ cargo install prodex
 
 The npm package version is kept in lockstep with the published crate version.
 
-## Update Tips
+## Update
 
-Check your installed version first:
+Check your installed version:
 
 ```bash
 prodex --version
 ```
 
-The current local binary version in this repo is `0.2.105`, so matching update commands look like this:
+The current local version in this repo is `0.2.108`:
 
 ```bash
-npm install -g @christiandoxa/prodex@0.2.105
-cargo install prodex --force --version 0.2.105
+npm install -g @christiandoxa/prodex@0.2.108
+cargo install prodex --force --version 0.2.108
 ```
 
-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:
+If you want to switch from a Cargo-installed binary to npm:
 
 ```bash
 cargo uninstall prodex
 npm install -g @christiandoxa/prodex
 ```
 
-## Quick Start
+## Start
 
-Import your current `codex` login:
+Import your current login:
 
 ```bash
 prodex profile import-current main
 ```
 
-Or create a profile through `codex login`:
+Or create a profile through the normal Codex login flow:
 
 ```bash
 prodex login
-```
-
-If you need device-code auth, pass it through unchanged:
-
-```bash
 prodex login --device-auth
 ```
 
-Check quotas:
+Check the pool:
 
 ```bash
+prodex profile list
 prodex quota --all
 prodex info
 ```
 
-Run `codex` with safe auto-rotate:
+## Use `prodex` for Codex CLI
+
+`prodex` without a subcommand is shorthand for `prodex run`.
 
 ```bash
 prodex
-prodex run
+prodex run --profile second
+prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
+printf 'context from stdin' | prodex run exec "summarize this"
 ```
 
-Running `prodex` without a subcommand is shorthand for `prodex run`.
+Use this path when you want Codex CLI itself to be the front end. Prodex handles profile selection, quota preflight, continuation affinity, and safe pre-commit rotation.
 
-Resume a saved Codex session directly:
+## Use `prodex claude` for Claude Code
 
 ```bash
-prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
+prodex claude -- -p "summarize this repo"
+prodex claude --profile second -- -p --output-format json "show the latest diff"
 ```
 
-Pin a specific profile when needed:
+Use this path when you want Claude Code to be the front end while Prodex still routes requests through your OpenAI-backed profile pool.
 
-```bash
-prodex run --profile second
-```
+- `prodex claude` runs Claude Code through a local Anthropic-compatible proxy
+- Claude Code state is isolated per profile in `CLAUDE_CONFIG_DIR`
+- the default Claude custom model follows the shared Codex `config.toml` model when available
+- use `PRODEX_CLAUDE_BIN` if `claude` is not on `PATH`
+- use `PRODEX_CLAUDE_MODEL` to force a specific upstream Responses model
+- use `PRODEX_CLAUDE_REASONING_EFFORT` to force the upstream reasoning tier
 
-`prodex run exec` also preserves stdin passthrough, so prompt and piped input stay together:
+Example:
 
 ```bash
-printf 'context from stdin' | prodex run exec "summarize this"
+PRODEX_CLAUDE_MODEL=gpt-5.2 PRODEX_CLAUDE_REASONING_EFFORT=xhigh prodex claude -- -p "hello"
 ```
 
-## Core Commands
+## Common Commands
 
 ```bash
-prodex
-prodex exec "review this repo"
 prodex profile list
 prodex use --profile main
-prodex info
+prodex current
 prodex quota --all
 prodex quota --all --once
+prodex info
 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
+## More
 
-For a slightly longer setup guide, see [QUICKSTART.md](./QUICKSTART.md).
+For a slightly longer walkthrough, see [QUICKSTART.md](https://github.com/christiandoxa/prodex/blob/main/QUICKSTART.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@christiandoxa/prodex",
-  "version": "0.2.106",
+  "version": "0.2.108",
   "description": "Safe multi-account auto-rotate for Codex CLI with isolated CODEX_HOME profiles",
   "license": "MIT",
   "bin": {
@@ -16,12 +16,12 @@
     "@openai/codex": "^0.118.0"
   },
   "optionalDependencies": {
-    "@christiandoxa/prodex-linux-x64": "0.2.106",
-    "@christiandoxa/prodex-linux-arm64": "0.2.106",
-    "@christiandoxa/prodex-darwin-x64": "0.2.106",
-    "@christiandoxa/prodex-darwin-arm64": "0.2.106",
-    "@christiandoxa/prodex-win32-x64": "0.2.106",
-    "@christiandoxa/prodex-win32-arm64": "0.2.106"
+    "@christiandoxa/prodex-linux-x64": "0.2.108",
+    "@christiandoxa/prodex-linux-arm64": "0.2.108",
+    "@christiandoxa/prodex-darwin-x64": "0.2.108",
+    "@christiandoxa/prodex-darwin-arm64": "0.2.108",
+    "@christiandoxa/prodex-win32-x64": "0.2.108",
+    "@christiandoxa/prodex-win32-arm64": "0.2.108"
   },
   "engines": {
     "node": ">=18"