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 + 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 Windows

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.)

Competitive token counting // yes, really

Share a 6-character code with friends. See their live token counts on your display. It's like a fitness tracker, but for your CLAUDE habit.

Row 3 rotates through your friends automatically. You'll know who's grinding.

YOU
84.70K
streaming now
ALEX
197.19K
2m ago
SAM
12.34K
just now
JULES
341.05K
4m ago

Share your code: A3KX9F → they add you → done.
Only output token counts are shared.

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.

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