Skip to content

v0.5.0

Choose a tag to compare

@garyleelty garyleelty released this 21 Oct 18:30
· 19 commits to main since this release

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/agentledger

or, 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.tgz

Still 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.