Documentation

Local subscription-value reports for Claude Code, Codex, and Cursor.

Agent Burn is a focused CLI for subscription-value analysis. It reads local logs and stays on this machine.

Site: agent-burn.melvynx.dev. Started from ccusage.

Getting Started

Getting StartedRun the local usage overview and add subscription value.

InstallationRun Agent Burn with npx, pnpm, bun, or Nix.

Commands

CLI OptionsPublic flags for summary, harness, and shared output.

JSON OutputMachine-readable reports for dashboards and scripts.

Data sources

Claude CodeWeekly harness and local log locations for Claude Code.

CodexWeekly harness and local log locations for Codex.

CursorCursor usage in the summary view, including charts and HTML.

Configuration

ConfigurationJSON defaults that CLI flags can still override.

Environment VariablesOverride local data-directory detection.

Configuration FilesLoad a specific JSON file with --config.

NextGetting Started