Repository navigation
v0.5.0
Ten agents now, and the windows your subscription actually bills in.
What is new
Billing blocks (agentledger blocks) — the rolling windows a
subscription quota resets in, with the active window's burn rate and
projection. ccusage has this as a Claude-Code-only report; this computes
it across all ten lanes, because a quota window is a property of the
subscription, not of the log format.
CodeBuddy CN — a tenth agent, and a third one only agentledger can
read. ccusage has no adapter for it at all (its "codebuff" is Manicode, a
different product). Its usage lives in four stores that have to be
joined — the extension log carries the token buckets, the history index
the clock, the message files the model, the sessions database the
working directory. 24.10M tokens on this machine.
One day boundary, not two. by-day counted days in UTC while
budget and statusline started the day at local midnight, so for a
user 8 hours from UTC they disagreed about what "today" meant. One
helper serves all three now, and --timezone picks the zone.
--until — the missing half of the date range, inclusive of the day
it names. 2026-02-30 is an error, not a rollover.
by-week and by-month — the daily report, rolled up. Weeks start
on Monday, in your zone.
--json returns the breakdown the command names. by-model --json
used to return all 18,017 records and no model breakdown, so a script
had to group them itself — the same work the command had already done,
thrown away on the way out. Six commands had this.
The agent's own cost, next to agentledger's estimate. Claude Code
writes its own costUSD on the log line; ccusage picks one of the two
numbers, this prints both and the difference between them. The stored
cost never prices anything — a test pins that the priced total does not
change when a cost field appears.
The statusline shows the active block — the gap this project used
to concede outright.
Install
brew install garyleelty/agentledger/agentledgeror, from a release tarball with no npm account and no registry:
npm install -g https://github.com/garyleelty/agentledger/releases/download/v0.5.0/agentledger-cli-0.5.0.tgzStill true
Zero dependencies. No network call of any kind — the input is your
entire coding history and it never leaves the machine. Node 22.5+.
And still true
Ten agents against ccusage's eighteen, and three of those ten are ones
ccusage cannot read at all.