Quickstart

Install tokenmaxxing, import your current account, and pool more

Requires Bun and Claude Code, on macOS or Linux. Install with Bun, or from the flake if you already use Nix / nix-darwin — put the CLI on PATH before init (see Build and distribution):

bun add -g tokenmaxxing
# or: nix profile install github:anaclumos/tokenmaxxing
# or: enable programs.tokenmaxxing in your nix-darwin / Home Manager config
tokenmaxxing init

init does five things:

  1. Imports the account you are already logged in with as account #1 (there is no separate adopt command).
  2. Installs the claude supervisor shim.
  3. Installs three entries in Claude Code's settings.json: a statusLine, a Stop hook, and a SessionStart hook (plus a subagentStatusLine entry).
  4. Appends the supervisor's bin directory to your shell rc's PATH (idempotent, marked with a # tokenmaxxing PATH comment). It has to sit ahead of the real claude on PATH to intercept it.
  5. Installs a periodic check timer (a launchd agent on macOS, a systemd user timer on Linux) that runs tokenmaxxing check every 180 seconds.

Restart your shell, then add more accounts and go:

tokenmaxxing add        # logs one more account in, in isolation, and pools it
claude                  # use claude as always

tokenmaxxing is also aliased as xx. Bare tokenmaxxing (or xx) runs status; switch stays explicit.