codeledger

Token-level cost intelligence for Claude Code.

[](https://www.npmjs.com/package/codeledger) [](./LICENSE) [](https://www.typescriptlang.org/) [](https://nodejs.org/)

CodeLedger is a Claude Code plugin that tracks where your AI coding tokens go — per-project, per-agent, per-skill — and separates your actual coding work from background plugin overhead. Ask questions conversationally via MCP tools, or browse the local dashboard.

Running Claude Code agents can burn through tokens fast. A single session with 49 parallel subagents can cost $8,000-$15,000. But you have zero visibility into:

• Which project costs the most?
• Which agent burned the most tokens?
• How much is plugin overhead (claude-mem observers, auto-compaction) vs your actual work?
• Are you using Opus for tasks that Sonnet handles just as well?

No existing tool answers these questions. CodeLedger does.

| Capability | ccusage | Agentlytics | tokscale | CodeLedger | |---|---|---|---|---| | Per-project tracking | Yes | Yes | No | Yes | | Per-agent token breakdown | No | No | No | Yes | | Per-skill attribution | No | No | No | Yes (~estimated) | | User vs overhead cost split | No | No | No | Yes | | Session category classification | No | No | No | Yes | | Cost optimization recommendations | No | No | No | Yes | | Conversational querying via MCP | No | No | No | Yes | | Local web dashboard | No | Yes | No | Yes | | Runs as Claude Code plugin | No | No | No | Yes |

# Add the MCP server
claude mcp add codeledger-server node -- $(npm root -g)/codeledger/dist/index.js

# Or install from source
git clone https://g