install token burner.

Token Burner is a Claude Code plugin. It runs entirely in your local session. No accounts. No telemetry. No data leaves your machine.

add the marketplace

From within a Claude Code session, run:

/plugin marketplace add github.com/token-arsonist/token-burner

install the plugin

/plugin install token-burner@token-burner-marketplace

Then reload to pick up the new slash commands:

/reload-plugins

verify

Run /burn-list. You should see the eight-recipe catalog. If you do, you're done.

command reference

Targets accept k (×1,000) and M (×1,000,000) suffixes. /burn 1.5M requests a Marathon-tier burn of 1,500,000 tokens.

settings

Optional configuration at $PWD/.token-burner.json or ~/.config/token-burner/config.json:

{
  "artifacts": "off",
  "artifact_dir": ".burn/",
  "default_target": null,
  "exclude_recipes": [],
  "marathon_threshold": 500000,
  "weekly_kpi": null
}

Set artifacts to "always" to write a markdown report of each session, or "opt-in" to require --save on the command line. Set weekly_kpi to enable the progress bar in /burn-status.