Skip to content

v0.1.0 — first public release

Choose a tag to compare

@garyleelty garyleelty released this 12 Oct 19:36
· 152 commits to main since this 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.