Skip to main content

Claude Code session cost analytics: your tokens are burning

Project description

Burnie

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 /burnie skill 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

burnie-0.1.1.tar.gz (395.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

burnie-0.1.1-py3-none-any.whl (130.0 kB view details)

Uploaded Python 3

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

Hashes for burnie-0.1.1.tar.gz
Algorithm Hash digest
SHA256 a1faf6980b1067e2fa9fadb87f123ce99811906014735ec754b2fb3a55c6c6b7
MD5 062bae831f379d7fbc0b2a70ab67a3f7
BLAKE2b-256 305c293e5380f8c9ee87aae9db2affcc9c0e237ad8df588cc8a7c2a85315c70f

See more details on using hashes here.

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

Hashes for burnie-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0e934e27743b2cf1eb2f2e410a232e203d4fa0dde4e59f8e40b7dda1a4c75c86
MD5 62342d6e5cedf094b0f99b11b6680dbf
BLAKE2b-256 2e22c4f16daa3e482a30e8740ff93831e7866e6aa9f6f7e399fc5631a4b37f40

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page