Skip to content

garvitsurana271/burnd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

burnd — find what's burning your Claude Code budget

npm npm downloads License: MIT

I spent $13,631 on Claude Code in 6 months and had no idea where it went. Built this to find out.

Burnd reads your local ~/.claude/projects/*.jsonl session files and finds the 8 patterns that waste your Claude Code money — with dollar estimates and concrete one-line fixes.

Free. Open source. Nothing leaves your machine.


Quickstart

npx getburnd

That's it. Output looks like this:

burnd v0.4.1 — scanning ~/.claude/projects/

  TOP 3 LEAKS THIS WEEK

  1  Long Bash output        23 sessions   est. $31.40 wasted
     fix: pipe through head/tail to cap output at 500 lines

  2  Late-night sessions     11 sessions   est. $18.20 wasted
     fix: your 01:00-04:00 sessions cost 2.4x more per task

  3  Repeated file reads     8 sessions    est. $9.60 wasted
     fix: one file read 19 times in a single session — use Edit not Read

  total estimated waste: $59.20  →  run 'npx getburnd serve' for full dashboard

Full dashboard (8 detectors, spend chart, per-project breakdown):

npx getburnd serve
# open http://localhost:4711

What it detects

Detector What it catches Typical monthly saving
Long Bash output Test runners / builds dumping 10k+ bytes into context $20–40/mo
Repeated reads Same file read 3+ times in one session (worst case: 31×) $10–20/mo
Tool error storms Agent thrashing on broken environments $30–50/mo
Tool overuse Bash dominating 70%+ of calls when Read/Grep would be cheaper $15–25/mo
Late-night sessions 00:00–05:00 sessions cost 2.5× more per task completed $50–200/mo
API retry storms Hidden in system records, invisible from the billing UI $5–15/mo
Skill over-firing Skills with broad triggers eating 40%+ of tool calls $10–30/mo
Project outliers Projects costing 3× your session median $20–40/mo

In my own data: $76/month in flagged waste. Fixed in a weekend.


How it works

Claude Code writes a .jsonl file for every session to ~/.claude/projects/. Each line is a structured event — tool calls, responses, token counts. Burnd parses these files locally, runs the 8 detectors, and estimates dollar waste from token consumption patterns.

It never connects to the internet. No telemetry, no account, no API key.


Privacy

  • Runs 100% locally — no server, no uploads, no accounts
  • Never reads your code, only the session metadata Claude Code writes itself
  • Parser source is in src/cli/src/ — audit it yourself
  • MIT license — fork it, self-host it, do whatever

The companion ebook

"Burning Tokens" — 7,400 words, 11 chapters. Every detector explained with real data from my $13,631 burn, plus the exact fixes that saved me $76/month.

₹399 (~$4.50) via UPI at getburnd.vercel.app/#buy


About

Built by Garvit Surana — 16, Class 12 ISC, Guwahati, India. After my Anthropic bill hit $13,631 over 6 months with no good tooling to understand why, I built this.

Contributing

Each detector is ~50 lines of TypeScript implementing the Detector interface. src/cli/src/detectors/long-bash-output.ts is the simplest one — copy it to add your own. PRs welcome.

License

MIT

About

Find what's burning a hole in your AI coding budget. Local-first cost-control for Claude Code.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors