@christiandoxa/prodex 0.137.0 → 0.139.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` | No | Runs through Prodex's local Responses-to-Anthropic adapter. |
+| 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` | No | API-key-only provider; no OAuth login profile in Prodex. |
+| Local OpenAI-compatible | `prodex super --url http://127.0.0.1:8131` | Local server auth/config | No | Injects a temporary local provider and skips quota preflight. |
+| Bedrock / custom Codex `model_provider` | `prodex run` / `prodex caveman` direct pass-through | Codex-owned config | No | Prodex does not proxy or quota-check these profiles. |
+
+<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 and imported Copilot profiles have provider-specific quota views. Anthropic, DeepSeek, API-key Gemini, API-key Copilot, local URLs, and Bedrock/custom Codex providers skip Prodex 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:
@@ -365,9 +391,10 @@ prodex login
 prodex profile add second
 prodex login --profile second
 prodex login --with-google
+prodex login --with-claude
 ```
 
-Interactive `prodex login` now asks for the login method before starting a browser. Choose ChatGPT browser login, device-code login, API-key login, or Google sign-in for Gemini. For API-key profiles, you can also set an OpenAI-compatible backend URL:
+Interactive `prodex login` now asks for the login method before starting a browser. Choose ChatGPT browser login, device-code login, API-key login, Google sign-in for Gemini, or Claude sign-in through Claude Code OAuth. For API-key profiles, you can also set an OpenAI-compatible backend URL:
 
 ```bash
 printf '%s\n' "$OPENAI_API_KEY" | prodex login --with-api-key --base-url http://localhost:11434/v1
@@ -401,6 +428,18 @@ prodex exec "review this repo"
 
 </details>
 
+<details>
+<summary>Import a Claude Code account</summary>
+
+```bash
+prodex profile import claude
+prodex profile import claude --name claude-main --activate
+```
+
+This imports the current Claude Code OAuth credentials from `CLAUDE_CONFIG_DIR` or `~/.claude` into a Prodex-managed Anthropic profile. You can also use `prodex login --with-claude` to sign in through Claude Code directly.
+
+</details>
+
 <details>
 <summary>Import a Copilot CLI account</summary>
 
@@ -415,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:
@@ -475,7 +514,7 @@ Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_
 
 ## Commands
 
-<details open>
+<details>
 <summary>Most used commands</summary>
 
 ```bash
@@ -522,9 +561,10 @@ prodex super --dry-run
 prodex quota --all
 prodex quota --all --once
 prodex quota --all --auth no-auth --once
+prodex quota --all --detail --provider openai
 ```
 
-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`, and `copilot`. Add `--provider openai`, `--provider gemini`, `--provider anthropic`, or `--provider copilot` to start locked to a single provider.
 
 </details>
 
@@ -630,6 +670,9 @@ RTK is still an external binary. Install it separately if `rtk gain` is unavaila
 ```bash
 prodex s
 prodex s exec "review this repo"
+ANTHROPIC_API_KEY=... prodex s --provider anthropic --model claude-sonnet-4-6
+prodex profile import copilot
+prodex s --provider copilot --model gpt-5.1-codex
 DEEPSEEK_API_KEY=... prodex s --provider deepseek --model deepseek-v4-pro
 prodex s --provider gemini
 prodex super
@@ -658,13 +701,32 @@ prodex super --mem-full
 
 Super also enables Smart Context Autopilot in the runtime proxy.
 
+Use `--provider anthropic` when you want the Codex/Super front end with Anthropic upstream:
+
+```bash
+prodex login --with-claude
+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.
+
+Use `--provider copilot` when you want the Codex/Super front end with GitHub Copilot upstream:
+
+```bash
+prodex profile import copilot
+prodex s --provider copilot --model gpt-5.1-codex
+```
+
+Without `--api-key`, Prodex uses imported Copilot CLI profiles, refreshes Copilot runtime API tokens from GitHub before launch, rotates fresh native Responses requests across eligible profiles, and binds streaming response IDs back to the owning profile for continuations. `GITHUB_COPILOT_API_KEY` or `--api-key` can be used when you already have a Copilot runtime API token.
+
 Use `--provider deepseek` when you want the Codex/Super front end with DeepSeek as the upstream model:
 
 ```bash
 prodex s --provider deepseek --model deepseek-v4-pro --api-key "$DEEPSEEK_API_KEY"
 ```
 
-If `--api-key` is omitted, Prodex reads `DEEPSEEK_API_KEY`. 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/account rotation 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. 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:
 
@@ -715,7 +777,7 @@ prodex claude --profile second -- -p --output-format json "show the latest diff"
 
 ## Profiles
 
-<details open>
+<details>
 <summary>Common profile commands</summary>
 
 ```bash

package/package.json

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