@christiandoxa/prodex 0.46.0 → 0.48.0

package/README.md

@@ -1,42 +1,21 @@
 # prodex
 
-`prodex` is a wrapper for Codex and Claude Code when you want to work with multiple isolated profiles.
+`prodex` is a wrapper for Codex and Claude Code for working with multiple profiles.
 
-Each profile can use a different account. For default OpenAI/Codex profiles, `prodex` checks quota and can route new work to another available profile. Existing sessions stay attached to the profile they started with.
+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.
 
-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 unavailable for that profile, and `prodex claude` is unsupported.
+It also keeps profiles isolated and keeps existing sessions attached to the profile they started with. For Codex CLI 0.124.0 and newer, Codex itself supports Amazon Bedrock and other OpenAI-compatible custom providers through `model_provider`; Prodex passes those profiles through directly instead of adding its OpenAI quota and rotation layer.
 
-It can also run Caveman mode and optionally connect Claude-Mem to the active session path.
+## Why use it
 
-## When to use it
+Use `prodex` if you want to:
 
-`prodex` is useful if you:
+- automatically use another available profile when quota runs out
+- work with multiple accounts
+- keep each profile isolated
+- keep sessions tied to the original profile
 
-- use multiple accounts for CLI agent workflows
-- want isolated profile environments
-- need quota checks before launch
-- want session continuity tied to the original profile
-
-If you only use one account and do not care about quota-aware routing or isolated homes, you probably do not need it.
-
-## Repository layout
-
-- `src/main.rs` — binary entrypoint
-- `src/lib.rs` — shared crate wiring and test support
-- `src/app_commands/`, `src/command_dispatch.rs`, `src/cli_args.rs` — CLI parsing and top-level command flow
-- `src/profile_commands/`, `src/quota_support/`, `src/secret_store/`, `src/profile_identity.rs` — profile, quota, secret storage, and identity management
-- `src/runtime_proxy/`, `src/runtime_launch/`, `src/runtime_persistence/`, `src/runtime_store/`, `src/runtime_broker/` — runtime internals
-- `src/runtime_claude/`, `src/runtime_anthropic/`, `src/runtime_caveman.rs`, `src/runtime_mem.rs` — Claude, Caveman, and memory integrations
-- `scripts/npm/` and `npm/` — npm packaging and publishing helpers
-
-## Supported commands
-
-- `prodex` / `prodex run`
-- `prodex caveman`
-- `prodex caveman mem`
-- `prodex claude`
-- `prodex claude caveman`
-- `prodex claude caveman mem`
+If you only use one account and do not need profile isolation or quota-aware routing, you probably do not need it.
 
 ## Requirements
 
@@ -45,7 +24,7 @@ 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` and `prodex claude caveman`
+- Claude Code for `prodex claude`
 - `claude-mem` for `mem` variants
 
 ## Install
@@ -56,15 +35,13 @@ Depending on your setup, you may also need:
 npm install -g @christiandoxa/prodex
 ````
 
-This installs `prodex` and pulls in the current Codex runtime dependency.
-
 ### Cargo
 
 ```bash
 cargo install prodex
 ```
 
-Cargo installs use the `codex` binary already available in your `PATH`, so you need to keep that updated separately.
+If you install with Cargo, make sure the `codex` binary in your `PATH` is already installed and up to date.
 
 ## Quick start
 
@@ -82,23 +59,21 @@ prodex profile add second
 prodex login --profile second
 ```
 
-Import a logged-in Copilot CLI account:
+You can also import a logged-in Copilot CLI account:
 
 ```bash
 prodex profile import copilot
 prodex profile import copilot --name copilot-main --activate
 ```
 
-Check available profiles and quota:
+Check your profiles and quota:
 
 ```bash
 prodex profile list
 prodex quota --all
 ```
 
-`prodex quota` supports OpenAI/Codex profiles and imported Copilot accounts. It does not support profiles whose `config.toml` selects a non-OpenAI `model_provider`.
-
-Run commands through `prodex`:
+Run through `prodex`:
 
 ```bash
 prodex
@@ -107,29 +82,11 @@ prodex caveman mem
 prodex exec "review this repo"
 prodex claude -- -p "summarize this repo"
 prodex claude mem -- -p "recall past work on this repo"
-prodex claude caveman -- -p "summarize this repo briefly"
-prodex claude caveman mem -- -p "summarize this repo briefly"
-```
-
-## Profile commands
-
-```bash
-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
 ```
 
-### Note on Copilot import
-
-`prodex profile import copilot` does not move the Copilot token into Prodex-managed storage. The token stays where Copilot already stores it. Prodex only records the provider identity and API endpoint in its own metadata.
+## Common commands
 
-## Codex examples
+### Run Codex
 
 ```bash
 prodex
@@ -140,9 +97,7 @@ prodex run 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
 printf 'context from stdin' | prodex run exec "summarize this"
 ```
 
-If the selected profile sets `model_provider` to a non-OpenAI backend, Prodex skips quota preflight and launches Codex directly without the local runtime proxy.
-
-## Caveman examples
+### Run Caveman mode
 
 ```bash
 prodex caveman
@@ -154,11 +109,9 @@ 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 the selected profile sets `model_provider` to a non-OpenAI backend, Prodex skips quota preflight and launches Caveman directly without the local runtime proxy.
-
 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`.
 
-## Claude Code examples
+### Run Claude Code
 
 ```bash
 prodex claude -- -p "summarize this repo"
@@ -173,11 +126,37 @@ prodex claude --profile second -- -p --output-format json "show the latest diff"
 
 `prodex claude` uses the normal Claude Code flow.
 
-This path requires the default OpenAI/Codex provider. Profiles whose `config.toml` sets a non-OpenAI `model_provider` are not supported by `prodex claude`.
+`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` loads Caveman only 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.
 
-`prodex claude caveman mem` combines both Caveman and Claude-Mem.
+## Profile commands
+
+```bash
+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
+```
+
+## Bedrock and custom providers
+
+Auto rotate and quota checks apply to supported OpenAI/Codex profiles.
+
+Codex CLI 0.124.0 added first-class Amazon Bedrock and OpenAI-compatible custom provider support. Configure that in the selected profile's Codex `config.toml`, for example with `model_provider = "amazon-bedrock"`.
+
+If a profile's `config.toml` sets `model_provider` to a non-OpenAI backend such as `amazon-bedrock`, `prodex run` and `prodex caveman` launch Codex directly without quota preflight or the local auto-rotate proxy. Bedrock quota, credentials, regions, and provider errors are handled by Codex and the upstream provider, not by Prodex.
+
+`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
 
@@ -188,8 +167,6 @@ prodex quota --all --once
 prodex doctor --runtime
 ```
 
-If Prodex returns `409 stale_continuation`, the request still carries continuation state, but the original binding is gone or no longer safe to reuse. Prodex refuses to fresh-replay that turn on another profile because continuation affinity is part of the request contract, and replaying it elsewhere can drop tool context or continue the wrong conversation. Start a new prompt or retry from the same live session if it still exists. If the failure looks unexpected, `prodex doctor --runtime` and the latest runtime log can show which continuation binding went stale.
-
 ## More
 
 See [QUICKSTART.md](./QUICKSTART.md) for a longer walkthrough.

package/package.json

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