@christiandoxa/prodex 0.2.96 → 0.2.98

package/README.md

@@ -1,12 +1,137 @@
-# @christiandoxa/prodex
+# prodex
 
-This package is the npm launcher for the native `prodex` binary.
+Safe multi-account auto-rotate for `codex`.
 
-It mirrors the published Rust crate version from crates.io and uses the same
-native-binary pattern as `@openai/codex`: npm resolves the right platform
-package, launches the native `prodex` binary, and injects a `codex` shim so the
-Rust binary can delegate to `@openai/codex` without requiring a separate global
-install.
+`prodex` wraps `codex` with isolated profiles, built-in quota checks, and seamless account rotation.
 
-The npm package version is intended to stay aligned with the published
-`prodex` crate version.
+## 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:
+
+```bash
+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
+cargo install prodex
+```
+
+The npm package version is kept in lockstep with the published crate version.
+
+## Update Tips
+
+Check your installed version first:
+
+```bash
+prodex --version
+```
+
+The current local binary version in this repo is `0.2.98`, so matching update commands look like this:
+
+```bash
+npm install -g @christiandoxa/prodex@0.2.98
+cargo install prodex --force --version 0.2.98
+```
+
+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:
+
+```bash
+cargo uninstall prodex
+npm install -g @christiandoxa/prodex
+```
+
+## Quick Start
+
+Import your current `codex` login:
+
+```bash
+prodex profile import-current main
+```
+
+Or create a profile through `codex login`:
+
+```bash
+prodex login
+```
+
+If you need device-code auth, pass it through unchanged:
+
+```bash
+prodex login --device-auth
+```
+
+Check quotas:
+
+```bash
+prodex quota --all
+prodex info
+```
+
+Run `codex` with safe auto-rotate:
+
+```bash
+prodex
+prodex run
+```
+
+Running `prodex` without a subcommand is shorthand for `prodex run`.
+
+Resume a saved Codex session directly:
+
+```bash
+prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
+```
+
+Pin a specific profile when needed:
+
+```bash
+prodex run --profile second
+```
+
+`prodex run exec` also preserves stdin passthrough, so prompt and piped input stay together:
+
+```bash
+printf 'context from stdin' | prodex run exec "summarize this"
+```
+
+## Core Commands
+
+```bash
+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](./QUICKSTART.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@christiandoxa/prodex",
-  "version": "0.2.96",
+  "version": "0.2.98",
   "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.96",
-    "@christiandoxa/prodex-linux-arm64": "0.2.96",
-    "@christiandoxa/prodex-darwin-x64": "0.2.96",
-    "@christiandoxa/prodex-darwin-arm64": "0.2.96",
-    "@christiandoxa/prodex-win32-x64": "0.2.96",
-    "@christiandoxa/prodex-win32-arm64": "0.2.96"
+    "@christiandoxa/prodex-linux-x64": "0.2.98",
+    "@christiandoxa/prodex-linux-arm64": "0.2.98",
+    "@christiandoxa/prodex-darwin-x64": "0.2.98",
+    "@christiandoxa/prodex-darwin-arm64": "0.2.98",
+    "@christiandoxa/prodex-win32-x64": "0.2.98",
+    "@christiandoxa/prodex-win32-arm64": "0.2.98"
   },
   "engines": {
     "node": ">=18"