@rikcodes/teamclaude 1.1.14-rik.2 → 1.1.19-rik.1

package/README.md

@@ -1,17 +1,12 @@
 # TeamClaude
 
-> **Fork notice (rikbrown).** This fork adds three features on top of
-> [KarpelesLab/teamclaude](https://github.com/KarpelesLab/teamclaude):
+> **Fork notice (rikbrown).** This fork adds two features on top of
+> [KarpelesLab/teamclaude](https://github.com/KarpelesLab/teamclaude), currently based on upstream 1.1.19:
 >
 > - **[OpenAI models via a Codex sidecar](docs/openai.md)** (`sidecars` + `customModels`, opt-in):
 >   route `gpt-*` requests through a supervised local translating proxy to a ChatGPT subscription,
 >   under real model names — `/model gpt-5.6-sol` in the picker and typed, correct 272k context
 >   sizing, and dispatchable GPT subagents — while Claude traffic stays on the Claude accounts.
-> - **[Soonest-weekly rotation](docs/routing.md#soonest-weekly-rotation)** (`soonestWeekly`, opt-in): rank
->   equal-priority accounts by the weekly window that governs the requested model, continuously — preempt the
->   current account when another resets more than `poolHours` sooner, and balance `distributeSessions` within
->   that pool instead of across all accounts. Spends the quota closest to refreshing first, so a window no
->   longer rolls over with quota unspent. Applied live on config reload.
 > - **[Burn-rate projection](docs/quota.md#burn-rate-projection)** (`projection`, on by default): sample each
 >   bucket's consumption over a rolling window and tag every account row with whichever window binds
 >   first — `Ses TTL 38m` when it runs out before it resets, `Wk 22% unspent` when the reset arrives
@@ -36,9 +31,9 @@
 [![node](https://img.shields.io/node/v/@rikcodes/teamclaude.svg)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-Multi-account Claude proxy with automatic quota-based rotation for [Claude Code](https://claude.ai/claude-code).
+Multi-account proxy for [Claude Code](https://claude.ai/claude-code) and [Codex](https://github.com/openai/codex): it pools Claude Max, ChatGPT/Codex, API-key and third-party backend accounts, and rotates on quota.
 
-It sits between Claude Code and the Anthropic API, holds several Claude Max (or API key) accounts, and moves to the next one when the current account gets close to its session or weekly limit. The session keeps running instead of stopping on a 429.
+It sits between the coding agent and the provider's API, holds several accounts, and moves to the next one when the current account gets close to its session or weekly limit. The session keeps running instead of stopping on a 429. Claude accounts serve Claude Code, Codex accounts serve the Codex CLI, and both pools share one proxy.
 
 ![TeamClaude TUI](screenshots/teamclaude.png)
 
@@ -54,18 +49,11 @@ teamclaude server    # start the proxy, shows the TUI
 teamclaude run       # in another terminal: Claude Code through the proxy
 ```
 
-Already logged into Claude Code? `teamclaude import` takes its credentials instead of a fresh OAuth round. API keys, and one email holding accounts in several orgs, are covered in [docs/accounts.md](docs/accounts.md).
-
-`teamclaude run` does not require a separate Claude Code login for normal API
-requests. When there is no usable local Claude OAuth (no login, or one that can
-no longer be refreshed), proxy credential mode supplies a local-only bootstrap
-key; the proxy replaces that placeholder
-with the selected TeamClaude account credential before forwarding.
+Already logged into Claude Code? `teamclaude import` takes its credentials instead of a fresh OAuth round. A container image is on GHCR — see [Running in a container](docs/usage.md#running-in-a-container). API keys, and one email holding accounts in several orgs, are covered in [docs/accounts.md](docs/accounts.md).
 
 ## What it does
 
 - Rotates to the next account when the 5h session or 7d weekly bucket reaches the threshold (98% by default), preferring the account whose weekly quota resets soonest.
-- Optionally spends the account whose weekly window resets soonest **first**, preempting the current account when another resets more than `poolHours` sooner, so a window stops rolling over with quota unspent (`soonestWeekly`, this fork).
 - Projects each quota window's burn rate against its reset, so a row says `Ses TTL 38m · Wk 22% unspent` instead of leaving you to read it off a bar (`projection`, this fork).
 - Tracks the per-model weekly cap separately, so an account out of Fable quota is skipped for Fable requests and still serves Opus and Sonnet.
 - Tells a spent quota bucket apart from a per-minute rate limit and only rotates on the first one. Rotating on a rate limit would just move the burst to the next account and drop the warm cache, so it paces the same account instead.
@@ -74,6 +62,7 @@ with the selected TeamClaude account credential before forwarding.
 - Catches hardcoded `api.anthropic.com` endpoints (the Claude Design MCP, for one) through a local MITM forward proxy, not only what `ANTHROPIC_BASE_URL` covers.
 - Holds the request open until quota resets instead of returning 429 when every account is spent, so an unattended run finishes on its own (`holdSeconds`, off by default).
 - Refreshes OAuth tokens before they expire and writes them back to config. Client refreshes pass through untouched.
+- Pools OpenAI Codex subscriptions alongside Claude accounts (experimental): the Codex CLI is routed through the same proxy, by config or transparently through the MITM proxy, and rotates on its own quota.
 - Takes any Anthropic-compatible API (DeepSeek, GLM) as a low-priority fallback for when the Claude accounts are done.
 - Serves OpenAI models next to Claude ones — a supervised local sidecar translates `gpt-*` requests onto a ChatGPT subscription, with real model names in `/model` and GPT subagents dispatchable from a Claude parent (`sidecars` + `customModels`, this fork).
 - No dependencies. Node built-ins only.
@@ -178,16 +167,6 @@ Claude Code prints one `[claude-code:unrecognized_model]` line to stderr for eac
 
 Full details: [docs/openai.md](docs/openai.md).
 
-### Soonest-weekly rotation
-
-Default selection is sticky. It re-ranks only when the current account is exhausted, so a weekly window can expire with unused quota. `soonestWeekly` re-ranks continuously. Among equal-priority accounts, the one whose governing weekly window resets soonest is used first. It preempts the current account when another account resets more than `poolHours` sooner.
-
-```json
-"soonestWeekly": { "enabled": true, "poolHours": 12 }
-```
-
-`distributeSessions` works with this setting. New sessions balance across that pool instead of across all equal-priority accounts. Both settings take effect when the configuration reloads (upstream applies `distributeSessions` only at startup). Details: [Routing](docs/routing.md#soonest-weekly-rotation).
-
 ### Burn-rate projection
 
 This feature is on by default. Each account row shows which window binds first: `Ses TTL 38m` when the session bucket runs out before it resets, or `Wk 22% unspent` when the weekly reset arrives first and that amount of quota expires. This is a readout only; no selection code reads it. Tune or disable it with `projection: { enabled, windowMinutes, wasteFloor }`. Details: [Quota](docs/quota.md#burn-rate-projection).
@@ -196,7 +175,7 @@ This feature is on by default. Each account row shows which window binds first:
 
 | Page | Contents |
 | --- | --- |
-| [Accounts](docs/accounts.md) | OAuth login, import, API keys, multiple orgs, third-party backends |
+| [Accounts](docs/accounts.md) | OAuth login, import, API keys, multiple orgs, Codex accounts, third-party backends |
 | [Usage](docs/usage.md) | Server and TUI, running Claude Code, shell alias, command reference, logging |
 | [Routing](docs/routing.md) | Rotation, the two kinds of 429, storm control, model routes, session spreading, pinning, prompt cache |
 | [Quota](docs/quota.md) | Quota probe, keep-warm, holding on exhaustion |
@@ -207,7 +186,7 @@ This feature is on by default. Each account row shows which window binds first:
 
 ## Releasing this fork
 
-Versions are `<upstream base>-rik.<n>`, e.g. `1.1.13-rik.1`. The self-updater orders that tail, so every publish reaches existing installs within a day.
+Versions are `<upstream base>-rik.<n>`, e.g. `1.1.19-rik.1`. The self-updater orders that tail and installs only that shape (`x.y.z` or `x.y.z-rik.N`), so every publish reaches existing installs within a day.
 
 1. Rebase onto the upstream release you want as the base, if any.
 2. Bump `version` in `package.json` and commit.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rikcodes/teamclaude",
-  "version": "1.1.14-rik.2",
-  "description": "Multi-account Claude proxy with automatic quota-based rotation",
+  "version": "1.1.19-rik.1",
+  "description": "Multi-account proxy for Claude Code and Codex: pools Claude Max, ChatGPT/Codex, API-key and third-party backend accounts, and rotates on quota",
   "type": "module",
   "main": "src/index.js",
   "bin": {
@@ -18,9 +18,17 @@
   "keywords": [
     "claude",
     "anthropic",
+    "claude-code",
+    "codex",
+    "openai",
+    "chatgpt",
+    "deepseek",
     "proxy",
     "load-balancer",
-    "multi-account"
+    "multi-account",
+    "quota",
+    "rate-limiting",
+    "cli"
   ],
   "license": "MIT",
   "repository": {