Repository navigation
v0.1.0 — first public release
agentledger — local-first cost ledger for AI coding agents
Reads the session logs your agents already write and turns them into tokens and dollars.
$ npx agentledger-cli
agentledger — 73 session files scanned
Metric Tokens Est. cost
───────────── ─────── ─────────
Input tokens 18.30M $20.74
Cache read 418.01M $43.58
Output tokens 1.47M $10.66
TOTAL 437.77M $74.98
Agent Tokens Est. cost Records
─────────── ─────── ───────── ───────
codex 219.58M $59.31 3053
claude-code 218.19M $15.67 3531
(real output from the machine it was written on)
Highlights
- Local only — reads
~/.claude/projects,~/.codex/sessions,~/.gemini/tmp. No network call anywhere in the codebase. - Cache-aware pricing — cache reads and cache writes are billed separately from fresh input, which most dashboards get wrong.
- Zero dependencies — Node 18+ and stdlib only. ~700 lines, auditable in one sitting.
- Fast — full scan of 400M+ tokens in about a second.
Commands
summary (default) · by-model · by-day · sessions · watch · prices · json · sources
Privacy
Opens log files read-only and writes nothing. No telemetry, no update check, no account.
MIT licensed and free forever.