tokenmaxx 0.0.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/LICENSE +1 -0
  2. package/README.md +112 -0
  3. package/dist/index.js +19184 -0
  4. package/package.json +61 -0
package/LICENSE ADDED
@@ -0,0 +1 @@
1
+ go nuts
package/README.md ADDED
@@ -0,0 +1,112 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="assets/brand/logo-dark.svg">
5
+ <source media="(prefers-color-scheme: light)" srcset="assets/brand/logo-light.svg">
6
+ <img alt="tokenmaxx" src="assets/brand/logo-dark.svg" width="440">
7
+ </picture>
8
+
9
+ <br/><br/>
10
+
11
+ **Juggle rate limits across all your Codex and Claude Code accounts — and see every token you burn.**
12
+
13
+ <sub>macOS · [Bun](https://bun.sh) · [tokenmaxx.sh](https://tokenmaxx.sh) · a [Rubric Labs](https://rubriclabs.com) project</sub>
14
+
15
+ <br/>
16
+
17
+ <picture>
18
+ <source media="(prefers-color-scheme: dark)" srcset="assets/generated/flagship-dark.png">
19
+ <source media="(prefers-color-scheme: light)" srcset="assets/generated/flagship-light.png">
20
+ <img alt="tokenmaxx beside live Claude Code and Codex sessions" src="assets/generated/flagship-dark.png">
21
+ </picture>
22
+
23
+ </div>
24
+
25
+ ## Install
26
+
27
+ ```bash
28
+ bun add -g tokenmaxx@alpha # pre-launch — drop @alpha at the first stable release
29
+ ```
30
+
31
+ ```bash
32
+ tokenmaxx login codex # sign in (isolated; existing sessions untouched)
33
+ tokenmaxx login claude
34
+ tokenmaxx install # route native codex & claude through tokenmaxx
35
+
36
+ codex # use the clients as before — tokenmaxx injects the account
37
+ claude
38
+ ```
39
+
40
+ ## What it does
41
+
42
+ You have more than one Codex and Claude subscription, and you keep hitting the five-hour or
43
+ weekly limit on whichever you're using. tokenmaxx runs a loopback proxy on `127.0.0.1:8459`
44
+ that reads the **active account per request** and injects its credential — so switching takes
45
+ effect on the very next request, even mid-turn, with the clients running unmodified.
46
+ Credentials stay in the macOS Keychain; nothing but opaque references touches disk.
47
+
48
+ ## Dashboard
49
+
50
+ Run `tokenmaxx` for a live dashboard. **Accounts** shows every account and its rate-limit
51
+ windows, colored by pressure; press space to expand one. **Tab** switches to **Analytics** —
52
+ a combined token-throughput view (tokens/time across every account and both providers) with
53
+ total tokens, peak tok/hr, and the **≈ API-list-price value** you're extracting from your flat
54
+ subscriptions. Tokens are metered by the proxy as responses stream by; it never buffers or
55
+ delays them.
56
+
57
+ <div align="center">
58
+ <picture>
59
+ <source media="(prefers-color-scheme: dark)" srcset="assets/generated/timelapse-dark.gif">
60
+ <source media="(prefers-color-scheme: light)" srcset="assets/generated/timelapse-light.gif">
61
+ <img alt="token throughput charting live" src="assets/generated/timelapse-dark.gif" width="820">
62
+ </picture>
63
+ </div>
64
+
65
+ ## Auto-rotation
66
+
67
+ Turn it on and tokenmaxx moves off an account the moment its fullest window crosses your
68
+ threshold, onto the one with the most headroom — mid-turn, on the next request. It's off by
69
+ default; enabling it is your confirmation that your provider permits this use.
70
+
71
+ ```bash
72
+ tokenmaxx auto both on --threshold 95 # or: codex | claude … off
73
+ ```
74
+
75
+ <div align="center">
76
+ <picture>
77
+ <source media="(prefers-color-scheme: dark)" srcset="assets/generated/switch-dark.gif">
78
+ <source media="(prefers-color-scheme: light)" srcset="assets/generated/switch-light.gif">
79
+ <img alt="an at-limit account rotating to a fresh one" src="assets/generated/switch-dark.gif" width="740">
80
+ </picture>
81
+ </div>
82
+
83
+ ## Commands
84
+
85
+ | Command | |
86
+ |---|---|
87
+ | `tokenmaxx` | Live dashboard |
88
+ | `tokenmaxx login <codex\|claude>` | Sign in (idempotent) |
89
+ | `tokenmaxx install` · `uninstall` | Route native clients · restore config |
90
+ | `tokenmaxx switch <codex\|claude> <email>` | Make an account active |
91
+ | `tokenmaxx auto <codex\|claude\|both> <on\|off> [--threshold N]` | Auto-rotation |
92
+ | `tokenmaxx list` · `status` · `refresh` · `doctor` | Accounts · JSON · re-probe · checks |
93
+
94
+ Env: `TOKENMAXX_HOME`, `TOKENMAXX_PROXY_PORT`, `TOKENMAXX_THEME`.
95
+
96
+ ## Not affiliated
97
+
98
+ tokenmaxx is an independent [Rubric Labs](https://rubriclabs.com) project. It is **not** an
99
+ official product of, affiliated with, or endorsed by OpenAI or Anthropic. Use only accounts
100
+ you own, and only where the relevant terms permit account automation.
101
+
102
+ ## Credits
103
+
104
+ Inspired by [`codex-account-switcher`](https://github.com/Sls0n/codex-account-switcher) by
105
+ [Sls0n](https://github.com/Sls0n) — thanks for the spark.
106
+
107
+ <div align="center">
108
+ <br/>
109
+ <a href="https://rubriclabs.com"><img alt="Rubric Labs" src="assets/brand/rubric-mark.svg" width="44"></a>
110
+ <br/>
111
+ <sub>Built by <a href="https://rubriclabs.com">Rubric Labs</a> · <a href="./LICENSE">go nuts</a></sub>
112
+ </div>