for the beautifully obsessed

TokenBox

A split-flap display for your Claude token usage.
Watch the numbers flip. See who's grinding. Feel the burn rate.

tokenbox — menu bar
live animation macos · linux · windows 100% local

Get started // one command

Install TokenBox and be watching your tokens flip in under 2 minutes.

>_

Install via terminalDownloads the app, wires up the Claude Code hook, and launches.

$ curl -fsSL https://tokenbox.club/install | bash
or download directly from GitHub Releases
macOS Linux Windows

Public or private // your call

Two ways to share your token count. Pick one, both, or neither.

Today's Token Leaders
Live
Pacific Time
| |

Leaderboard launching soon

What you get // besides serotonin

TokenBox reads your Claude Code logs and turns raw token counts into something you can stare at.

{ }

Real-time split-flap display

Every token streams in live. Characters cycle sequentially through the drum — just like the departure board at the train station you haven't visited since you started using Claude for everything.

>_

Lives in your menu bar

No dock icon. No window management. Just a quiet amber number ticking up in your menu bar, reminding you that yes, you are in fact still streaming.

~

Today / Week / Month / Total

Pin any time period to the main display. The rest rotate through automatically. Watch your monthly number and feel things.

Per-model filtering

See just Opus. Just Sonnet. Just Haiku. Or go full degenerate and show all models combined. We don't judge. (We do count.)

One identity, every machine // tokenbox link

Use Claude Code on your laptop and your VM? Link your devices — combined tokens, one leaderboard rank, one view for friends.

MacBook
24,031
+
Linux VM
18,744
=
You
42,775
1 Generate a link codetokenbox link
2 Paste on other devicetokenbox link TB-XXX-XXX
3 Done. Tokens merge instantly.

Paranoid by design // as you should be

no accounts no telemetry no cloud sync reads local logs only never writes to ~/.claude/ open source

TokenBox reads Claude Code's local JSONL logs and that's it. Your data lives in a SQLite database on your machine. Friend sharing is opt-in and only exposes display name + token count — the absolute minimum needed to flex on your friends.

Full setup walkthrough // ~2 minutes

No build step. No config file. No existential crisis. (That comes later, when you see your monthly total.)

1

Install the app

One command installs TokenBox, wires up the Claude Code hook, and launches. Historical data backfills automatically from existing logs.

curl -fsSL https://tokenbox.club/install | bash
2

Watch the flaps flip

Start a Claude conversation. Your menu bar lights up. The split-flap clicks to life. That's it. You're done.

3

Add friends (optional, but recommended)

Open Settings, register a display name, share your 6-character code. Peer pressure has never been so quantified.

4

Go public (optional, but you want to)

Join the daily leaderboard. Pick a username, opt in, and let the world see your output token count. It's anonymous enough to feel safe and public enough to feel competitive. Top of the board resets every night at midnight Pacific.

You're already burning tokens.
Might as well watch.