Claude Code session cost analytics: your tokens are burning
Project description
Some agents just want to watch your tokens burn.
burnie is a local cost analytics tool for Claude Code. It reads the session transcripts Claude Code stores on disk and gives you a clear picture of where your money is going: no API key, no cloud, just your files.
Features
- Report: visual HTML breakdown of token costs across all your Claude Code sessions: total spend, daily average, cache savings, cost by model
- Inspect: drill into any session to see what drove the cost: context growth over time, tool call patterns, agent spawns, repeated operations
- Analyze: the
/burnieskill runs a condensed report through Claude for a written, reasoned take on where your cost is coming from and what (if anything) to do about it
Install
# run without installing
uvx burnie
# or install as a persistent command
uv tool install burnie
No uv? pip install burnie works too.
Then get the /burnie skill into Claude Code:
burnie --install-skill
Usage
# Generate HTML report
burnie
# Highlight a specific session in the report
burnie --session <session-id>
# Markdown report instead of HTML
burnie --markdown
# Condensed, LLM-readable report printed to stdout (what the `/burnie` skill uses)
burnie --raw --session <session-id>
The report is written to burnie-report.html in the current directory and opened in your browser. --markdown writes burnie-report.md instead. --raw prints straight to stdout with no file.
How it works
Claude Code writes every session to a JSONL file at:
~/.claude/projects/<encoded-project-path>/<session-id>.jsonl
Each assistant turn includes token usage. burnie reads those files, applies current model pricing from src/burnie/pricing.py, and surfaces the data.
Pricing
Stored in src/burnie/pricing.py, the single source of truth. Run /burnie-update to refresh from Anthropic's pricing page.
Burnie doesn't judge. It just burnies. 🔥
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file burnie-0.1.1.tar.gz.
File metadata
- Download URL: burnie-0.1.1.tar.gz
- Upload date:
- Size: 395.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a1faf6980b1067e2fa9fadb87f123ce99811906014735ec754b2fb3a55c6c6b7
|
|
| MD5 |
062bae831f379d7fbc0b2a70ab67a3f7
|
|
| BLAKE2b-256 |
305c293e5380f8c9ee87aae9db2affcc9c0e237ad8df588cc8a7c2a85315c70f
|
File details
Details for the file burnie-0.1.1-py3-none-any.whl.
File metadata
- Download URL: burnie-0.1.1-py3-none-any.whl
- Upload date:
- Size: 130.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0e934e27743b2cf1eb2f2e410a232e203d4fa0dde4e59f8e40b7dda1a4c75c86
|
|
| MD5 |
62342d6e5cedf094b0f99b11b6680dbf
|
|
| BLAKE2b-256 |
2e22c4f16daa3e482a30e8740ff93831e7866e6aa9f6f7e399fc5631a4b37f40
|