gitwtfhub

wtf is tokenmaxx?

rubriclab/tokenmaxx — explained in plain English

Analysis updated 2026-05-18

23TypeScriptAudience · developerComplexity · 2/5Setup · easy

TL;DR

A macOS CLI dashboard and local proxy that tracks usage across multiple Codex and Claude Code accounts and auto-switches between them.

Mindmap

mindmap
  root((repo))
    What it does
      Live rate-limit dashboard
      Local proxy per-request switching
      Auto-rotation on threshold
    Tech stack
      TypeScript
      Bun
      macOS Keychain
    Use cases
      Monitor multiple accounts
      Auto-switch on rate limit
      Track token spend live
    Audience
      Developers
      Power users of AI coding tools

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor rate-limit pressure across several Codex and Claude Code accounts in one dashboard.

REASON 2

Automatically switch to whichever account has the most remaining usage room during a long session.

REASON 3

Track combined token throughput and estimated API-list cost across all your accounts live.

REASON 4

Manually switch which signed-in account your coding clients use before starting a task.

What's in the stack?

TypeScriptBunmacOS

How it stacks up

rubriclab/tokenmaxxad3lre/echoaffaan-m/x-algorithm-score
Stars232323
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/54/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

macOS only, requires Bun and existing Codex or Claude Code subscription logins.

The license file is described casually as go nuts, implying a very permissive license, but the exact terms are not detailed in the README.

Wtf does this do

tokenmaxx is a macOS command line tool that gives you one dashboard for all your Codex and Claude Code accounts, so you can see how much of your usage limit each one has left and switch between them without restarting anything. If you run multiple coding agent sessions across several accounts, it keeps them all signed in locally and lets you pick which one your clients actually use at any moment. It works through a small local proxy running on your machine. Whichever account you have set as active gets its credentials attached to every request your coding agent makes, and switching accounts takes effect on the very next request, even in the middle of a task. Your login credentials stay in the macOS Keychain and are never sent anywhere except to the provider that issued them, either OpenAI or Anthropic. Running the tokenmaxx command opens a live dashboard with three parts. The accounts view shows every signed in account with its current rate limit usage, sorted by how close each one is to its limit, along with plan tier and when the limit resets. The analytics view shows combined token throughput across every account and both providers as it happens, plus an estimated cost at each provider's list price, calculated from the live stream of responses rather than stored logs. The settings view lets you turn providers on or off and configure automatic account rotation. Auto rotation is an optional feature that watches your active account's usage and switches to whichever account has the most room left once a threshold, 90 percent by default, is crossed. If a request happens to hit a hard limit mid way through, the proxy automatically retries it on another account that still has capacity. The README is explicit that tokenmaxx is meant for one person managing accounts they personally pay for, not for sharing or pooling accounts across people, and that users are responsible for checking their own provider's terms of service before using this kind of account switching. The project is written in TypeScript, installed with the Bun package manager, and its license file says simply go nuts.

Yoink these prompts

Prompt 1
Install tokenmaxx with bun add -g tokenmaxx and walk me through signing in my Codex and Claude accounts.
Prompt 2
Turn on auto-rotation in tokenmaxx for both Codex and Claude with a 90 percent threshold.
Prompt 3
Show me how to manually switch my active Claude Code account using the tokenmaxx switch command.
Prompt 4
Explain how the tokenmaxx local proxy attaches credentials to each request and what it can see.
Prompt 5
Run tokenmaxx doctor and help me interpret the output if something looks wrong.

Frequently asked questions

wtf is tokenmaxx?

A macOS CLI dashboard and local proxy that tracks usage across multiple Codex and Claude Code accounts and auto-switches between them.

What language is tokenmaxx written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, macOS.

What license does tokenmaxx use?

The license file is described casually as go nuts, implying a very permissive license, but the exact terms are not detailed in the README.

How hard is tokenmaxx to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is tokenmaxx for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.