Repository navigation
Releases
Releases · jskoiz/token-ledger
tledger 0.4.0
Token Ledger 0.4.0
Highlights
- One-day PNG reports now show hourly token usage and cache efficiency, with
a partial current hour and support for daylight-saving transitions. - Add
--privateto a report to replace project names with ranked anonymous
labels. Usage figures stay visible, the source snapshot stays unchanged,
and the default output filename ends in-private.png. - Recognize Astra in usage reports. Models without bundled prices remain
explicitly unrated in purchased-credit and API-equivalent estimates. - Keep model names and token amounts readable in narrow bars, with floating
labels for small segments and captions for small model-mix shares. - Show unrecorded fast-mode status separately from confirmed fast usage.
Correctness and reliability
- Allocate compacted usage across local calendar and hourly boundaries, retain
persisted call counts, and compare equivalent partial reporting periods. - Keep report cutoffs fixed during collection and disclose allocated estimates.
- Repair token timestamps that precede their own recorded turn, preserve token
totals, and mark the replacement time as estimated. - Reject impossible quota-window timestamps so valid meter history remains
visible, and keep meter attribution separate from daily token precision. - Correct detailed-call coverage for total-only records while retaining valid
partial coverage in compacted history. - Preserve competing snapshot replacements during publication checks.
- Redact local project paths during legacy migration and report materialization,
and redact local paths in CLI and collector diagnostics. - Reject malformed quota readings, handle fragmented terminal key sequences,
and tolerate XML-invalid label characters during PNG encoding. - Improve cross-month labels, narrow chart spacing, peak-hour labels, and
fallback to token bars when observed drain is unavailable. - Preserve persisted thread-title updates and isolate benchmark state from the
live ledger.
Release checks and requirements
Requires Node.js 22.13 or newer. CI and prepublish checks include regular and
stress tests, lint, and offline installation of the packed artifact with CLI
and PNG smoke tests. Token Ledger remains a local-only CLI.
tledger 0.3.1
What's changed
- Current-day reports now end at the latest verified local data time instead of drawing a misleading flat line through the rest of the day.
- Weekly-limit readings are clearly identified as OpenAI-reported; dashed holds mean the report is awaiting another provider update.
- Report generation cheaply checks local source modification times and only reruns the full parser when the sources changed.
- Partial-day/report-time labels, responsive chart details, and timezone-aligned trend boundaries are corrected.
Verification
- 161 automated tests passed.
- GitHub CI passed on Node 22.13.0 and Node 26.x.
- GitGuardian checks passed.
- The release tarball passed clean-install, CLI, report PNG, and cache-report PNG smoke tests.
tledger 0.3.0
Highlights
- Rebuilt the 7-day report around actual token volume, corrected Luna/model representation, continuous weekly-meter lines, aligned cache reporting, and safe project-label truncation.
- Added bounded, privacy-reduced gzip snapshots with adaptive historical rollups, a 16 MiB compressed cap, and a 64 MiB decompression limit.
- Allocated boundary-spanning compacted history proportionally so day, rolling-window, chart, cache, project, and quota totals remain additive.
- Simplified the default CLI help to the essential commands while retaining the full reference under
tledger --help-all.
Install
npm install -g tledger@0.3.0Published on npm as tledger@0.3.0.
Verification
Validated on Node 22.13 and Node 26, including 159 tests, lint, clean tarball installation, terminal smoke tests, and both PNG report paths.
tledger 0.1.4
What is new
- Model Mix now names every active model, including Daybreak Blue and previously unrecognized identifiers.
- The new -anon option replaces project names with Project 1, Project 2, and so on in terminal output.
- Height-aware fullscreen rendering keeps navigation controls and key usage sections visible as the model list grows.
- The new --version and -v options report the installed package version.
Release quality
- Verified on exact Node 22.13.0 and Node 26.
- Publication is gated by 36 tests and an isolated eight-file packed-install check.
- The public synthetic demo now covers Daybreak Blue and unrecognized model names.
Install or update
npm install --global tledger@0.1.4