patheonsceo / tokburn

your code.
your creature.

A pixel art companion for Claude Code. It blinks, reacts to your token usage, roasts your spending, and evolves as you write more code. Also a full session dashboard.

›npm i -g tokburn

FLINTPIXELMOCHI

STARTERS 3 · EVOLUTIONS 9 · QUIPS 152 · EXPRESSIONS 5 · DOWNLOADS 2.5K+ · PRICE $0.00 · DEPENDENCIES 0 · RENDER_TIME <5ms · STARTERS 3 · EVOLUTIONS 9 · QUIPS 152 · EXPRESSIONS 5 · DOWNLOADS 2.5K+ · PRICE $0.00 · DEPENDENCIES 0 · RENDER_TIME <5ms · STARTERS 3 · EVOLUTIONS 9 · QUIPS 152 · EXPRESSIONS 5 · DOWNLOADS 2.5K+ · PRICE $0.00 · DEPENDENCIES 0 · RENDER_TIME <5ms ·

00 // THE PROBLEM

You're coding blind.

tokburn fixes this.

01 // THE DASHBOARD

Everything. Live. Always.

Your Tokemon lives in the Claude Code status line — with a full session dashboard updating every second.

claude — tokburn

━━━──

Context Bar

Live context usage. Know when you're running out before you lose everything.

◆◆◇◇◇

Rate Limits

5-hour and 7-day windows with diamond bars, percentages, and reset countdowns.

+156/-23

Lines & Tokens

Lines added/removed and tokens in/out. Track what Claude is actually doing.

⎇ main*

Git Branch

Current branch with dirty indicator. Always know where you are.

▰▰▰▱▱

XP & Level

Your Tokemon's progress bar filling toward the next level and evolution.

🧠 💭

152 Quips

Rotating personality commentary. Your Tokemon reacts to what's happening live.

02 // COMPANIONS

Choose your starter.

Three creatures. Three personalities. Pick one and it's yours forever.

A flame spirit who roasts your spending with deadpan precision. Evolves into Blaze, then Inferno.

"you code like someone who hates money"

✦

Claude Code v2.1.97

Opus 4.6 (1M context) · Claude Max

~/projects/my-app

user: build me an auth system with JWT and session management

● Building authentication module...

Read src/auth/middleware.ts

Read src/auth/providers.ts

Read src/config/oauth.ts

Edit src/auth/session.ts +47 -12

Edit src/routes/login.ts +23

Write src/auth/jwt.ts +68

✓ Auth module complete. 4 files changed.

Token refresh, session store, JWT signing.

● Running tests...

✓ 12 passed (0.8s)

● Adding rate limiting middleware...

Write src/middleware/rateLimit.ts +34

✓ Rate limiter added.

›

Type a message...

Opus 4.6 (1M)·Max ━━━━━─────── 42%

5h ◆◆◆◇◇◇◇◇◇◇ 31% | ⎇ main*

Lv.3 Flint ▰▰▰▱▱▱▱▱ → Lv.4

03 // EVOLUTION

They grow with you.

Every line of code earns XP. Your Tokemon evolves at 5,000 and 50,000 lines — across all projects, all sessions.

Lv.1

Flint

A tiny flame wisp with big curious eyes. Just hatched.

STARTER FORM

FLINT

Stage 1 of 3

04 // EXPRESSIONS

They react to you.

5 expressions that change in real-time. Rate limit climbing? Your Tokemon feels it.

CHILL

◆◇◇◇◇◇◇◇◇◇

12%

Everything's calm. Your Tokemon is vibing — mostly normal expression with occasional blinks.

05 // INTERFACE

Initialize.

Two commands. No config files, no env vars, no proxy. Just install and init.

terminal

$ npm i -g tokburn

added 47 packages in 5s

$ tokburn init

✓ Plan ................. Max (~2M/5hr)

✓ Tokemon .............. Flint

✓ Personality ........... Sassy

✓ Status line ........... Recommended

— Your Tokemon has hatched! —

Flint the Fire type

"oh great. you again."

Install globally

One npm command. Works on Linux, macOS, and Windows.

Run the wizard

Pick your plan, choose your Tokemon, select a personality.

Code

Open Claude Code. Your Tokemon is there. Blinking, watching, judging.

Requires Claude Code v2.1.97+
Run claude update if needed

Your Tokemon is waiting.

$npm i -g tokburn