I kept getting blindsided by Claude Code rate limits. So I built tokburn, a status line extension that shows rate limits, context usage, and token stats in real-time.
Then I made it fun.
Hit 2.1k npm downloads in the first week. PRs welcome, especially if you want to design new creatures.
What it looks like
Your status line goes from Opus 4.6 (1M context) | ctx 13% to a full dashboard with an animated pixel art companion.
The Tokemon system
You pick a starter creature during setup. It lives in your status line, blinks, reacts to your session state, and drops personality quips.
At 60% rate limit, it gets stressed. At 85%, full panic mode. When Claude writes enough code, it evolves, new sprite, new name, 30-second gold celebration.
Three starters (Flint, Pixel, Mochi), three evolution stages each, four personality types (sassy, hype, anxious, chill), 152 unique quips.
The technical bit
No proxy, no interception, no cloud. Claude Code sends JSON to the status line script via stdin every second. tokburn parses it, loads companion state from a local JSON file, renders the 6-line layout, updates XP, and writes to stdout. Under 5ms per frame. Zero external dependencies.
Try it-
npm i -g tokburn
tokburn init
Top comments (0)