Skip to content
Trazum

2.5.1

A bill for a period

A patch on 2.5's terms, and no command. bill --since/--until bills a period, as profile has long windowed one: a period the log does not reach is refused rather than printed at $0, and a call with no timestamp is left out and named, on the statement and on the receipt as a new gap, undated-excluded. trazum receipt takes the same flags. A bill spanning months adds a table by month. A Claude Code bill says what its figure is: Anthropic's API rates, which somebody on a Pro or Max plan did not pay. bill stops calling every prefixed model id an OpenRouter slug, and names the ones it prices under their own name. The Action pin moves to 2.5.0.

Added#

  • bill --since/--until: a bill for a period. A Claude Code folder holds every session since the tool was installed, so bill with no window answered "what has this ever cost". --since 2026-10-01 is this month so far. The window is profile's, read the same way (a UTC day, a timestamp, 30d, now; a bare day is the whole of it; half-open underneath, so adjacent months share no call), and the statement and the PDF, HTML and Markdown documents say which period they bill. A period the log does not reach is refused with the dates the log covers, never printed as a $0 bill. A call with no timestamp cannot be placed, so it is left out and counted: on the statement, and on the receipt as a new gap, undated-excluded, with the total called a floor on the period. trazum receipt takes the same two flags, through the same code, so a receipt and a bill of one period agree.

  • A bill that spans months says which month cost what. Once the calls span two calendar months, the statement adds a table by month (the newest twelve, the rest counted), says how much from undated calls sits in no month, and names the --since/--until that bills the newest month on its own. Summed from the report's own days, so the rows and the total cannot disagree. packages/cli/test/bill-window.test.js (14 tests) and two in receipt-arithmetic.test.js.

Fixed#

  • The packaged Action pin in README.md and docs/running.md advanced to 2.5.0's release commit, the one v2.5.0 points at, in the pull request after the release as docs/releasing.md says it must.

  • A Claude Code bill did not say it is an API-rate equivalent. bill over Claude Code transcripts prints "Your bill" at Anthropic's API rates, and somebody on a Pro or Max plan paid the plan, not that figure. The README said so in its subscription section; the statement, the PDF, HTML and Markdown documents and the web app's Bill tab did not. Each now says it whenever transcripts were read, and never over a metered API log, where the figure is money billed. The README picture is redrawn from the new output.

  • bill called every model id with a slash an OpenRouter slug. gemini/, xai/ and moonshot/ are LiteLLM's prefixes (OpenRouter writes google/, x-ai/, moonshotai/), so the hint stated a fact it did not know. It now says the ids carry a provider prefix and that --pricing-live prices OpenRouter's. And where the model after the slash is one the catalogue prices under its own name, it names those ids and says why the prefix is not stripped for you: the same model through a router can bill differently, so pricing it by rule would be the guess this product does not make.

  • A date --since/--until could not read was refused with half the forms it takes. The message named a UTC day and an ISO timestamp; the parser also takes a relative window (7d, 24h) and now, and now says so, in English and Spanish.