How tokburn got 2.5K downloads by being a pet that roasts you

Most dev tools compete on features. tokburn competed on personality.

The idea

I was burning through Claude Code tokens and had no visibility into my usage. The dashboard existed, but who checks a dashboard mid-flow? I needed something in my terminal, where I already live.

But a usage tracker is boring. Nobody shares a usage tracker on Twitter.

A pixel art creature that lives in your terminal, evolves as you code, and roasts your spending habits? That gets shared.

What shipped

TOKEMON LIFECYCLE

  starter         stage 1            stage 2
 ┌───────┐       ┌───────┐          ┌───────┐
 │  ◔ ◔  │  ──▶  │  ◉ ◉  │   ──▶   │  ✦ ✦  │
 │   v   │  use  │   ▽   │   abuse │   ◆   │
 └───────┘       └───────┘          └───────┘
   "hi"          "hmm..."          "$$$ again?"

  3 starters · 9 evolutions · 152 personality quips

LIVE DASHBOARD

 ┌─────────────────────────────────────────────────┐
 │  ☄ tokburn  ·  feature/ticker-fix  ·  claude-4  │
 ├─────────────────────────────────────────────────┤
 │  context   ▰▰▰▰▰▰▱▱▱▱  62%                      │
 │  rate      ▰▰▱▱▱▱▱▱▱▱  21%   resets in 04:12    │
 │  spend     ▰▰▰▰▰▰▰▰▱▱  $4.20 today              │
 │                                                 │
 │  >> "you spent $4 on a one-line fix. iconic."   │
 └─────────────────────────────────────────────────┘

• 3 starter Tokemon, 9 total evolutions
• 152 personality quips tied to token usage thresholds
• Live dashboard: context window, rate limits, git branch awareness
• Zero dependencies. Single npm install.

What I learned

1. Personality is a feature. The roasting is why people install it. The dashboard is why they keep it.
2. Zero-dep matters. Nobody wants to debug your dependency tree for a fun terminal pet.
3. Ship the fun version first. I almost built a "serious" token tracker. Thank god I didn't.

2.5K downloads in a few weeks. Open source. Still growing.