@christiandoxa/prodex 0.138.0 → 0.140.0

package/README.md

@@ -1,13 +1,14 @@
 # prodex
 
-`prodex` is a multi-account Codex wrapper with auto-rotation.
+`prodex` is a multi-account, multi-provider Codex wrapper with auto-rotation.
 
-Use multiple Codex accounts from one command line. When the active account runs out of quota, `prodex` can route the next work to another available account.
+Use multiple Codex accounts and supported provider backends from one command line. OpenAI/Codex profiles get quota-aware routing and auto-rotation; provider adapters let `prodex s` launch the Codex front end against Gemini, Anthropic, Copilot, DeepSeek, and local OpenAI-compatible servers.
 
 ## Contents
 
 - [Why prodex](#why-prodex)
 - [Requirements](#requirements)
+- [Supported providers](#supported-providers)
 - [Installation](#installation)
 - [Optional tools](#optional-tools)
 - [Quick start](#quick-start)
@@ -27,6 +28,7 @@ Use `prodex` if you want to:
 
 - use multiple Codex accounts from one CLI
 - rotate to another account when quota runs out
+- launch Codex/Super against non-OpenAI providers without changing front ends
 - keep profile credentials separated
 - keep sessions attached to the profile that created them
 - run Codex, Caveman mode, Super mode, and Claude Code through the same wrapper
@@ -44,9 +46,33 @@ You need at least one logged-in Prodex profile.
 | Claude-Mem | `mem` variants |
 | RTK | `rtk` variants and `prodex s` / `prodex super` |
 
+## Supported providers
+
+Prodex supports two provider paths:
+
+- **Profile-backed routing**: persisted profiles that Prodex can select, rotate, and inspect where provider APIs allow it.
+- **Runtime provider launch**: `prodex s --provider ...` / `prodex super --provider ...` starts Codex with a temporary provider bridge for that session.
+
+| Provider | Launch to Codex | Auth path | Quota view | Notes |
+|---|---:|---|---:|---|
+| OpenAI / Codex | `prodex`, `prodex run`, `prodex s` | ChatGPT OAuth, device code, or OpenAI/API-compatible key via `prodex login` | Yes | Full quota preflight and profile auto-rotation. |
+| Google Gemini | `prodex s --provider gemini` | Google OAuth via `prodex login --with-google`, or `GEMINI_API_KEY` / `--api-key` | OAuth profiles | OAuth mode can rotate across Gemini profiles; API-key mode is runtime-only. |
+| Anthropic Claude | `prodex s --provider anthropic` | Claude Code OAuth via `prodex login --with-claude` / `prodex profile import claude`, or `ANTHROPIC_API_KEY(S)` / `--api-key` | OAuth profiles | Shows Claude OAuth readiness; add `ANTHROPIC_ADMIN_KEY` to include Anthropic Admin rate-limit groups. |
+| GitHub Copilot | `prodex s --provider copilot` | Imported Copilot CLI profile via `prodex profile import copilot`, or `GITHUB_COPILOT_API_KEY` / `--api-key` | Imported profiles | Native Copilot profile mode keeps continuations bound to the owning profile. |
+| DeepSeek | `prodex s --provider deepseek` | `DEEPSEEK_API_KEY(S)` / `--api-key` | API-key balance | `prodex quota --all --provider deepseek` reads DeepSeek `/user/balance`. |
+| Local OpenAI-compatible | `prodex super --url http://127.0.0.1:8131` | Local server auth/config | Health snapshot | `prodex quota --all --provider local --base-url ...` checks the local `/models` endpoint. |
+| Bedrock / custom Codex `model_provider` | `prodex run` / `prodex caveman` direct pass-through | Codex-owned config | Config snapshot | Prodex reports configured provider metadata; provider-side quota stays owned by Codex/upstream. |
+
+<details>
+<summary>Provider behavior details</summary>
+
+The auto-rotate proxy is intentionally conservative. It rotates only before a request or stream is committed, preserves `previous_response_id`, turn-state, and session affinity, and does not rotate mid-stream. OpenAI/Codex remains the default quota-aware pool. Gemini OAuth, imported Copilot profiles, Anthropic OAuth profiles, DeepSeek API keys, local OpenAI-compatible URLs, and Bedrock/custom Codex providers now have `prodex quota` views. Anthropic, DeepSeek, API-key Gemini, API-key Copilot, local URLs, and Bedrock/custom Codex providers still skip OpenAI quota preflight.
+
+</details>
+
 ## Installation
 
-<details open>
+<details>
 <summary>Install from npm</summary>
 
 ```bash
@@ -346,7 +372,7 @@ When you answer `y` to the `prodex super` / `prodex s` Presidio prompt or pass `
 
 ## Quick start
 
-<details open>
+<details>
 <summary>Import your current Codex login</summary>
 
 If your current Codex home is already logged in:
@@ -428,7 +454,7 @@ When you import a Copilot profile, Prodex does not move the Copilot token into P
 
 ## Daily command: `prodex s`
 
-<details open>
+<details>
 <summary>Super mode overview</summary>
 
 For daily work, I use:
@@ -488,7 +514,7 @@ Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_
 
 ## Commands
 
-<details open>
+<details>
 <summary>Most used commands</summary>
 
 ```bash
@@ -535,9 +561,12 @@ prodex super --dry-run
 prodex quota --all
 prodex quota --all --once
 prodex quota --all --auth no-auth --once
+prodex quota --all --detail --provider openai
+prodex quota --all --provider deepseek --once
+prodex quota --all --provider local --base-url http://127.0.0.1:8131/v1 --once
 ```
 
-The live `prodex quota --all --detail` view accepts `s` to cycle sort modes and `f` to cycle the provider filter through `all`, `openai`, and `gemini`.
+The live `prodex quota --all --detail` view accepts `s` to cycle sort modes and `f` to cycle the provider filter through `all`, `openai`, `gemini`, `anthropic`, `copilot`, `deepseek`, and `local`. Add `--provider openai`, `--provider gemini`, `--provider anthropic`, `--provider copilot`, `--provider deepseek`, or `--provider local` to start locked to a single provider.
 
 </details>
 
@@ -682,7 +711,7 @@ prodex s --provider anthropic --model claude-sonnet-4-6
 prodex s --provider anthropic --model claude-sonnet-4-6 --api-key "$ANTHROPIC_API_KEY"
 ```
 
-If `--api-key` is omitted, Prodex uses the Anthropic profile created by `prodex login --with-claude` or `prodex profile import claude`. API-key mode still reads `ANTHROPIC_API_KEY`; `ANTHROPIC_API_KEYS` may contain multiple comma-, semicolon-, or newline-separated keys for round-robin request rotation. This path injects a temporary `prodex-anthropic` Codex provider, exposes a local `/v1/responses` adapter to Codex, forwards to Anthropic's OpenAI-compatible chat API, and keeps quota preflight disabled.
+If `--api-key` is omitted, Prodex uses the Anthropic profile created by `prodex login --with-claude` or `prodex profile import claude`. API-key mode still reads `ANTHROPIC_API_KEY`; `ANTHROPIC_API_KEYS` may contain multiple comma-, semicolon-, or newline-separated keys for round-robin request rotation. This path injects a temporary `prodex-anthropic` Codex provider, exposes a local `/v1/responses` adapter to Codex, forwards to Anthropic's OpenAI-compatible chat API, and keeps quota preflight disabled. `prodex quota --all --provider anthropic` shows OAuth readiness for Anthropic profiles; set `ANTHROPIC_ADMIN_KEY` when you want Anthropic Admin rate-limit groups included.
 
 Use `--provider copilot` when you want the Codex/Super front end with GitHub Copilot upstream:
 
@@ -699,7 +728,7 @@ Use `--provider deepseek` when you want the Codex/Super front end with DeepSeek
 prodex s --provider deepseek --model deepseek-v4-pro --api-key "$DEEPSEEK_API_KEY"
 ```
 
-If `--api-key` is omitted, Prodex reads `DEEPSEEK_API_KEY`; `DEEPSEEK_API_KEYS` may contain multiple comma-, semicolon-, or newline-separated keys for round-robin request rotation. This path injects a temporary `prodex-deepseek` Codex provider, exposes a local `/v1/responses` adapter to Codex, forwards to DeepSeek's OpenAI-format chat API, and keeps quota preflight disabled. Prodex also injects a one-model Codex catalog for the selected DeepSeek model, so `/model` stays on that model and offers the DeepSeek-compatible `high`/`xhigh` effort choices. The Super optional tools still run normally because they are local launch overlays around Codex. Remote compact is not implemented for this adapter yet, so the default DeepSeek context window is large and `--auto-compact-token-limit` defaults high.
+If `--api-key` is omitted, Prodex reads `DEEPSEEK_API_KEY`; `DEEPSEEK_API_KEYS` may contain multiple comma-, semicolon-, or newline-separated keys for round-robin request rotation. This path injects a temporary `prodex-deepseek` Codex provider, exposes a local `/v1/responses` adapter to Codex, forwards to DeepSeek's OpenAI-format chat API, and keeps quota preflight disabled. Prodex also injects a one-model Codex catalog for the selected DeepSeek model, so `/model` stays on that model and offers the DeepSeek-compatible `high`/`xhigh` effort choices. `prodex quota --all --provider deepseek` reads the same `DEEPSEEK_API_KEY(S)` environment and fetches DeepSeek `/user/balance`. The Super optional tools still run normally because they are local launch overlays around Codex. Remote compact is not implemented for this adapter yet, so the default DeepSeek context window is large and `--auto-compact-token-limit` defaults high.
 
 Use `--provider gemini` when you want the Codex/Super front end with Gemini upstream:
 
@@ -750,7 +779,7 @@ prodex claude --profile second -- -p --output-format json "show the latest diff"
 
 ## Profiles
 
-<details open>
+<details>
 <summary>Common profile commands</summary>
 
 ```bash
@@ -797,6 +826,12 @@ By default, Prodex:
 - advertises a conservative 16k local context window
 - skips quota/proxy routing for that launch
 
+Check local server reachability with:
+
+```bash
+prodex quota --all --provider local --base-url http://127.0.0.1:8131/v1 --once
+```
+
 The default local model id is:
 
 ```bash
@@ -880,13 +915,13 @@ Set `PRODEX_SHARED_CODEX_HOME` only when you intentionally want a different shar
 <details>
 <summary>Bedrock and custom providers</summary>
 
-Auto-rotate and quota checks apply to supported OpenAI/Codex profiles. `prodex quota` also supports Google Gemini OAuth profiles and imported Copilot accounts through their provider quota APIs.
+Auto-rotate and quota checks apply to supported OpenAI/Codex profiles. `prodex quota` also supports Google Gemini OAuth profiles, Anthropic OAuth profiles, imported Copilot accounts, DeepSeek API-key balances, local OpenAI-compatible health snapshots, and configured custom providers.
 
 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 quota` shows the configured provider metadata for those profiles instead of failing the view.
 
 </details>
 

package/package.json

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