contextburn
by arsentev-ai
Contextburn is a command-line tool that reads the transcripts Claude Code saves on your computer. It works out what share of the tokens you paid for became real output rather than the agent re-reading earlier context.
- Stars
- 0
- Licence
- MIT
- Runs on
- Your computer
- Setup
- Easy
- Language
- Python
- Age
- 52 days
What you can do with it
- See what share of your Claude Code tokens became output versus context re-reading
- Check the current 5-hour subscription window and what is burning tokens right now
- Let the agent read its own run efficiency mid-session through the built-in MCP server
Ways a business could use it
- Find out which working habits waste tokens and cut the cost of running Claude Code day to day
- Compare efficiency across projects or team members to decide when to clear context and keep subscription use within limits
Can you use it commercially?
Free to use, change and sell, including in paid products. Keep the copyright notice.
Not legal advice. Read the project's licence file before building a product on it.
Add it to Claude Code
claude mcp add contextburn -- uvx contextburn
From the official MCP Registry (ai.arsentev/contextburn). Only connect MCP servers you trust: they can act on your behalf.
Getting it running
Copy the single Python script into your bin folder and make it executable; it needs only python3 and has no dependencies.
Follow the official instructions in the project README.
Things to check
- Very new project with no stars yet
- Only supports Claude Code transcripts
- Cost-weighted figures depend on a price table you must update by hand
- Written for Unix-style shells; the menu-bar app is macOS only, so Windows use may need extra effort
Checked 03 Nov 2026. Summary drafted by AI from the project's README.
