Claude Agent Ledger

claude-agent-ledger

See exactly where your Claude Code budget goes — per subagent, per model, per day.

[](https://www.npmjs.com/package/claude-agent-ledger) [](LICENSE)

Use `--anonymize` before sharing output. It replaces project paths and session IDs, but it does not rename subagent or tool names — review those before you post a screenshot.

---

Why

Claude Code's invoice at month-end tells you one number. It doesn't tell you:

• Which of your subagents burned most of it
• Which model (Opus / Sonnet / Haiku) ate the budget
• Which day of last week was the expensive one
• Whether your "cheap" Haiku agent is actually quietly expensive

If you run **one** Claude Code session, this is fine — you already know. If you run **seven** subagents daily (reliability, release, review, iOS factory, docs, ...), you're flying blind.

`claude-agent-ledger` reads Claude Code's local session logs and gives you a per-subagent ledger. That's it.

Install

Requires [Bun](https://bun.sh/) 1.1 or newer. The CLI is Bun-native even when you install it from npm.

bun install -g claude-agent-ledger
# or, with Bun already available: npm install -g claude-agent-ledger

agent-ledger week --summary        # the dashboard (start here)
agent-ledger week --tree           # parent → child subagent attribution
agent-ledger week --by tool        # which tool ate the budget (Read/Bash/Grep/MCP)
agent-ledger week --by model       # opus vs sonnet vs haiku
agent-ledger week --by project     # which project ate your tokens
agent-ledger week --by session     # which single sessions went sideways
agent-ledger week --by day         # daily bar chart with peak/avg/variance
agent-ledger today --budget 50     # CI gate: exit 2 if today > $50
agent-ledger week --json | jq      # JSON output for any view, including summary
agent-ledger month --md > report.md

# Live tail