@christiandoxa/prodex 0.2.126 → 0.2.127

package/README.md

@@ -2,32 +2,51 @@
 
 [![CI](https://github.com/christiandoxa/prodex/actions/workflows/ci.yml/badge.svg)](https://github.com/christiandoxa/prodex/actions/workflows/ci.yml)
 
-`prodex` manages multiple isolated Codex profiles and lets Codex CLI or Claude Code run on top of the same OpenAI account pool.
+Run multiple isolated Codex profiles on the same OpenAI account pool, with smart quota checks, clean profile separation, and continuation-aware routing.
 
-It is built for a simple setup:
+`prodex` helps you manage multiple Codex identities without turning your workflow into a mess.
 
-- each account gets its own profile
-- quota is checked before launch
-- fresh work can move to another ready profile
-- existing continuations stay on the profile that already owns them
+It is designed around a simple model:
+
+- **One account = one profile**
+- **Quota is checked before launch**
+- **Fresh work can move to another ready profile**
+- **Existing continuations stay with the profile that already owns them**
+
+That means you can keep working smoothly across multiple accounts while preserving session continuity where it matters.
+
+## Why `prodex`?
+
+Not everyone wants to pay $200 for a single account.
+
+Sometimes it makes more sense to run 2 or 3 separate $20 accounts you already have. The problem is that doing it manually is annoying fast. You have to log in, log out, switch homes, check quota, and keep track of which session belongs to which account.
+
+`prodex` exists to remove that pain.
+
+It manages isolated profiles for each account, checks quota before launch, routes fresh work to an available profile, and keeps ongoing continuations attached to the right one.
+
+Less account juggling, less friction, more actual work.
 
 ## 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`
+Before using `prodex`, make sure you have:
+
+- **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`.
+> Installing `@christiandoxa/prodex` from npm also installs the Codex runtime dependency for you.  
+> Claude Code is still a separate CLI and must already be available on your `PATH` if you want to use `prodex claude`.
 
 ## Install
 
-Install from npm:
+### npm
 
 ```bash
 npm install -g @christiandoxa/prodex
 ```
 
-Or install from [crates.io](https://crates.io/crates/prodex):
+### Cargo
 
 ```bash
 cargo install prodex
@@ -43,14 +62,14 @@ Check your installed version:
 prodex --version
 ```
 
-The current local version in this repo is `0.2.126`:
+The current local version in this repo is `0.2.127`:
 
 ```bash
-npm install -g @christiandoxa/prodex@0.2.126
-cargo install prodex --force --version 0.2.126
+npm install -g @christiandoxa/prodex@0.2.127
+cargo install prodex --force --version 0.2.127
 ```
 
-If you want to switch from a Cargo-installed binary to npm:
+Switching from a Cargo-installed binary to npm?
 
 ```bash
 cargo uninstall prodex
@@ -65,21 +84,21 @@ If your shared Codex home already contains a login:
 prodex profile import-current main
 ```
 
-Or create a profile through the normal login flow:
+Or create a profile through the usual login flow:
 
 ```bash
 prodex login
 prodex login --device-auth
 ```
 
-If you want to name the profile first:
+Want to name the profile first?
 
 ```bash
 prodex profile add second
 prodex login --profile second
 ```
 
-Check the pool:
+Check your profile pool and quota status:
 
 ```bash
 prodex profile list
@@ -95,11 +114,50 @@ prodex exec "review this repo"
 prodex claude -- -p "summarize this repo"
 ```
 
-`prodex` without a subcommand is shorthand for `prodex run`.
+> `prodex` without a subcommand is shorthand for `prodex run`.
+
+## Common Workflows
+
+### 1. Create or import profiles
+
+```bash
+prodex profile import-current main
+prodex profile add second
+prodex login --profile second
+```
+
+### 2. Inspect your pool
+
+```bash
+prodex profile list
+prodex quota --all
+prodex info
+```
+
+### 3. Run Codex with automatic profile selection
+
+```bash
+prodex
+prodex run
+prodex exec "review this repo"
+```
+
+### 4. Resume an existing session on the correct profile
+
+```bash
+prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
+```
+
+### 5. Run Claude Code through the same profile pool
+
+```bash
+prodex claude -- -p "summarize this repo"
+prodex claude --profile second -- -p --output-format json "show the latest diff"
+```
 
-## Important Commands
+## Command Reference
 
-### Profile And Login
+### Profile & Login
 
 ```bash
 prodex profile list
@@ -114,7 +172,7 @@ prodex logout --profile main
 prodex profile remove second
 ```
 
-### Run With Codex CLI
+### Run with Codex CLI
 
 ```bash
 prodex
@@ -125,14 +183,14 @@ prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
 printf 'context from stdin' | prodex run exec "summarize this"
 ```
 
-### Run With Claude Code
+### Run with Claude Code
 
 ```bash
 prodex claude -- -p "summarize this repo"
 prodex claude --profile second -- -p --output-format json "show the latest diff"
 ```
 
-### Export And Import Profiles
+### Export & Import Profiles
 
 ```bash
 prodex profile export
@@ -141,9 +199,10 @@ prodex profile export --profile main --profile second backup.json
 prodex profile import backup.json
 ```
 
-`prodex profile export` includes each exported profile's `auth.json`. By default it exports every configured profile and asks whether the bundle should be password-protected.
+`prodex profile export` includes each exported profile’s `auth.json`.
+By default, it exports every configured profile and asks whether the bundle should be password-protected.
 
-### Quota, Status, And Debugging
+### Quota, Status & Debugging
 
 ```bash
 prodex quota --all
@@ -163,13 +222,14 @@ prodex doctor --runtime
 tail -n 200 "$(cat /tmp/prodex-runtime-latest.path)"
 ```
 
-Use `prodex cleanup` to remove stale local runtime logs, temp login homes, dead broker leases and registries, plus old orphaned managed profile homes that are no longer tracked in state.
+Use `prodex cleanup` to remove stale local runtime logs, temporary login homes, dead broker leases and registries, plus old orphaned managed profile homes that are no longer tracked in state.
 
 ## Notes
 
-- Managed profiles share persisted Codex state through Prodex-owned shared storage.
-- `prodex quota --all` refreshes live by default. Use `--once` for a one-shot snapshot.
+* Managed profiles share persisted Codex state through Prodex-owned shared storage.
+* `prodex quota --all` refreshes live by default.
+* Use `--once` if you only want a one-shot snapshot.
 
-## More
+## Learn More
 
 For a longer walkthrough, see [QUICKSTART.md](./QUICKSTART.md).

package/package.json

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