GitHub - RubricLab/tokenmaxx: A local proxy that aggregates usage across your Codex and Claude Code accounts — with live token-throughput analytics. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
RubricLab
tokenmaxx
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>55 Commits<br>55 Commits
.github/workflows
.github/workflows
bin
bin
media
media
src
src
.gitignore
.gitignore
CHANGELOG.md
CHANGELOG.md
LICENSE
LICENSE
README.md
README.md
biome.json
biome.json
bun.lock
bun.lock
package.json
package.json
tsconfig.json
tsconfig.json
View all files
Repository files navigation
One dashboard for all of your Codex and Claude Code accounts. Easily switch between them, and monitor usage.
macOS · Bun · a Rubric Labs project · not affiliated with OpenAI or Anthropic
Install
bun add -g tokenmaxx
tokenmaxx #starts the dashboard
What it does
You run a fleet of coding agents using multiple Codex or Claude accounts:
tokenmaxx keeps them all signed in locally and lets you choose which one your clients use. A small proxy on your machine attaches the active account's credential to each request, so a switch takes effect on the very next request, even mid-turn. Your credentials live in the macOS Keychain and never go anywhere except to the provider that issued them.
The dashboard
Run tokenmaxx. Accounts shows every account and its live rate-limit windows, colored by pressure, with plan tier and reset countdowns inline. Rows sort by pressure; the ● marks where traffic is going right now.
Analytics is combined token throughput across all accounts and both providers, with the ≈ cost of that usage at API list rates. Tokens are metered as responses stream by, never buffered, so every number is cross-checkable against your clients' own session logs. Press m for the full pricing breakdown per model.
Settings holds the master on/off per provider, then auto-rotation, the switch threshold, and cooldown, applied live.
Auto-rotation
Turn it on and tokenmaxx watches the active account's rate-limit windows. When the fullest one crosses your threshold, it switches to whichever of your accounts has the most room. The default threshold is 90%, which leaves the last stretch of every window alone in case you want it later. If an account hits a hard limit in the middle of a request, the proxy retries that request on your next account with room.
tokenmaxx auto both on --threshold 90 # or: codex | claude … off
How it works
A single loopback proxy on 127.0.0.1:8459, and the clients you already use.
Account per request. The proxy reads which account is active for each request and attaches its credential. Switching lands on the next request.
Pressure read for free. Both providers report rate-limit state on every response; the proxy reads it as traffic streams by, so it always knows how full the active account is, with zero extra requests.
Official apps only. Your subscription login is for Claude Code and Codex. If you're building something custom, use an API key from the provider. tokenmaxx doesn't turn a subscription into an API plan.
Commands
sign in; isolated, idempotent<br>tokenmaxx install route native codex & claude<br>tokenmaxx uninstall restore native config<br>tokenmaxx switch make an account active<br>tokenmaxx auto [--threshold N]<br>tokenmaxx list | status | refresh | doctor">tokenmaxx live dashboard<br>tokenmaxx login sign in; isolated, idempotent<br>tokenmaxx install route native codex & claude<br>tokenmaxx uninstall restore native config<br>tokenmaxx switch make an account active<br>tokenmaxx auto [--threshold N]<br>tokenmaxx list | status | refresh | doctor
Env: TOKENMAXX_HOME, TOKENMAXX_PROXY_PORT, TOKENMAXX_THEME.
Intended use
tokenmaxx is for one person with accounts they pay for themselves. No account gets bigger limits, no limit gets bypassed, and your credentials stay between your Keychain and the provider. Don't share accounts, don't pool...