tokenmaxxing 1.108.0 → 1.109.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenmaxxing",
-  "version": "1.108.0",
+  "version": "1.109.0",
   "description": "Automatic Claude Code account switching: pool multiple accounts, start each session on its own account, and resume a session on a fresher account when quota fills.",
   "type": "module",
   "license": "MIT",

package/src/cli/seat.ts

@@ -6,18 +6,18 @@ import { emitError } from "./render.ts";
 const POOLS = {
   claude: {
     borrow: borrowClaudeSeat,
-    usage: "usage: tokenmaxxing seat <pid> - print the CLAUDE_SECURESTORAGE_CONFIG_DIR of one pooled claude account, lent to <pid> alone until it exits",
-    none: "no usable claude account (pool empty, every account lent to another borrower, or every account at a limit or flagged for reauthentication)",
+    usage: "usage: tokenmaxxing seat <pid> - print the CLAUDE_SECURESTORAGE_CONFIG_DIR of one pooled claude account, lent to <pid> until it exits and shared with host sessions and other borrowers",
+    none: "no usable claude account (pool empty, or every account at a limit or flagged for reauthentication)",
   },
   codex: {
     borrow: borrowCodexSeat,
-    usage: "usage: tokenmaxxing seat --codex <pid> - print the CODEX_HOME of one pooled account, reserved until <pid> exits",
+    usage: "usage: tokenmaxxing seat --codex <pid> - print the CODEX_HOME of one pooled account, reserved to <pid> alone until it exits, because one codex auth.json serves one machine or one serialized job stream (https://learn.chatgpt.com/docs/auth/ci-cd-auth)",
     none: "no usable codex account (pool empty, every account live in another session, or every account at a limit) - use the ambient codex login",
   },
   "opencode-go": {
     borrow: borrowOpencodeGoSeat,
-    usage: "usage: tokenmaxxing seat --opencode-go <pid> - print the store directory of one pooled opencode-go key, whose auth.json is an opencode auth file, lent to <pid> alone until it exits",
-    none: "no usable opencode-go key (pool empty, every key lent to another borrower, or no store holds a usable key)",
+    usage: "usage: tokenmaxxing seat --opencode-go <pid> - print the store directory of one pooled opencode-go key, whose auth.json is an opencode auth file, lent to <pid> until it exits and shared with other borrowers",
+    none: "no usable opencode-go key (pool empty, or no store holds a usable key)",
   },
 };
 

package/src/lib/claude.ts

@@ -163,8 +163,7 @@ export async function borrowClaudeSeat(pid: number): Promise<SeatBorrow> {
       }
       return { store: storeDirFor(heldAccount.id), id: heldAccount.id, reused: true };
     }
-    const lent = new Set(living.filter((p) => p.id.startsWith("seat-")).map((p) => p.accountId));
-    const open = idx.accounts.filter((a) => a.needsReauth !== true && !lent.has(a.id));
+    const open = idx.accounts.filter((a) => a.needsReauth !== true);
     const usable = await Promise.all(open.map(storeUsable));
     const ctx: PickCtx = { now: Date.now(), thresholds: bars, currentId: null, families: gatedFamilies(null, cfg.policy.switchModels), seats: presence() };
     const picked = pickBest(open.filter((_, i) => usable[i]), ctx);

package/src/lib/opencodego.ts

@@ -1,4 +1,5 @@
 import { join } from "node:path";
+import { countBy, minBy } from "es-toolkit";
 import { z } from "zod";
 import { writeFileAtomic } from "./atomic.ts";
 import { env, HOME, opencodeGoAuthJsonFor, opencodeGoPaths, opencodeGoPool, opencodeGoStoreDirFor } from "./paths.ts";
@@ -63,10 +64,9 @@ export async function borrowOpencodeGoSeat(pid: number): Promise<SeatBorrow> {
       }
       return { store: opencodeGoStoreDirFor(heldAccount.id), id: heldAccount.id, reused: true };
     }
-    const lent = new Set(living.map((p) => p.accountId));
-    const open = accounts.filter((a) => !lent.has(a.id));
-    const usable = await Promise.all(open.map(opencodeGo.storeUsable));
-    const picked = open.find((_, i) => usable[i]);
+    const lent = countBy(living, (p) => p.accountId);
+    const usable = await Promise.all(accounts.map(opencodeGo.storeUsable));
+    const picked = minBy(accounts.filter((_, i) => usable[i]), (a) => lent[a.id] ?? 0);
     if (!picked) return null;
     writePresence({ dir: opencodeGoPaths.presenceDir, id: seatId, accountId: picked.id, pid });
     return { store: opencodeGoStoreDirFor(picked.id), id: picked.id, reused: false };

package/src/lib/picker.ts

@@ -122,6 +122,7 @@ const swapPreference = (ctx: PickCtx) => [
   (a: Account) => -pacePressure(a, ctx),
   (a: Account) => weeklyExpiry(a, ctx.now),
   (a: Account) => weeklyWindow(a)?.usedPercentage ?? 101,
+  ...(ctx.seats == null ? [] : [(a: Account) => ctx.seats?.get(a.id) ?? 0]),
 ];
 
 export function pickBest(accounts: Account[], ctx: PickCtx): Account | null {

package/src/main.ts

@@ -60,9 +60,9 @@ function printHelp(): void {
   ${c.cyan("tokenmaxxing doctor")}     verify the install is intact
   ${c.cyan("tokenmaxxing rename")} [--codex | --grok | --opencode-go] <sel> <label>
   ${c.cyan("tokenmaxxing rm")} [--codex | --grok | --opencode-go] <sel>
-  ${c.cyan("tokenmaxxing seat")} <pid>  lend one pooled Claude account to an unattended consumer until <pid> exits: prints the store directory to set as CLAUDE_SECURESTORAGE_CONFIG_DIR (the directory itself, as its owner, never a copy of its credential); host sessions keep using the account, other borrowers do not; exit 1 = none usable
-  ${c.cyan("tokenmaxxing seat --codex")} <pid>  borrow one pooled codex account for an unattended consumer (plugin, script): prints the CODEX_HOME to set, reserved until <pid> exits; exit 1 = none usable, fall back to the ambient login
-  ${c.cyan("tokenmaxxing seat --opencode-go")} <pid>  lend one pooled opencode-go key to an unattended consumer until <pid> exits: prints the store directory, whose auth.json is an opencode auth file (mount it at $XDG_DATA_HOME/opencode/auth.json, then run a model such as opencode-go/mimo-v2.6-pro); other borrowers do not get the key; exit 1 = none usable
+  ${c.cyan("tokenmaxxing seat")} <pid>  lend one pooled Claude account to an unattended consumer until <pid> exits: prints the store directory to set as CLAUDE_SECURESTORAGE_CONFIG_DIR (the directory itself, as its owner, never a copy of its credential); host sessions and other borrowers share the account; exit 1 = none usable
+  ${c.cyan("tokenmaxxing seat --codex")} <pid>  borrow one pooled codex account for an unattended consumer (plugin, script): prints the CODEX_HOME to set, reserved to <pid> alone until it exits because one auth.json serves one serialized job stream; exit 1 = none usable, fall back to the ambient login
+  ${c.cyan("tokenmaxxing seat --opencode-go")} <pid>  lend one pooled opencode-go key to an unattended consumer until <pid> exits: prints the store directory, whose auth.json is an opencode auth file (mount it at $XDG_DATA_HOME/opencode/auth.json, then run a model such as opencode-go/mimo-v2.6-pro); other borrowers share the key; exit 1 = none usable
   ${c.cyan("tokenmaxxing serve")}      serve the CLIProxyAPI-compatible usage API on http://localhost:<hub.port> (default 8317) so a dashboard such as T3 Code's "Add a CLIProxyAPI hub" shows every pooled Claude and Codex account's quota; the management key is the contents of hub-key in the state directory
   ${c.cyan("tokenmaxxing uninstall")} [--yes]  print the targets, then remove supervisor + settings entries (refused without ${c.cyan("--yes")} when HOME is the login home)