Repository navigation
AI Usage Tracker 0.8.2
Today's trend now compares like with like, limit readings and usage are kept in more edge cases, and many small rough edges are gone.
Fixes
- A fair trend for today. On the Overview, Today used to compare the hours so far with all of yesterday, so most mornings showed a large drop. It now compares with yesterday up to the same time. 7 days and 30 days work the same way.
- Status line readings with several sessions. When two Claude Code sessions updated their status lines at the same moment, their limit readings could be lost. Each reading is now written whole.
- Tips follow the account filter. With an account selected, the tool error tip on Tips counted the tool calls of your other accounts too.
- Usage budgets count the account in use. A token or cost budget you set for a window now counts only the account you are using, and another account's reading no longer hides it.
- Logs rewritten in place. If a sync or backup tool rewrote a Claude Code or Codex log in place and it grew past its old end, part of the new lines was skipped for good. The log is now read again from its start.
- Records from a clock that ran ahead. Usage dated more than a day ahead of your clock (for example from a machine whose clock was wrong) was skipped for good. It is now read once your clock reaches it.
- OpenCode keeps reading. A single damaged OpenCode record stopped all OpenCode usage from being read. Only that record is skipped now.
- Settings saved while the tray changes them. Changing a setting in the window no longer undoes a change you made from the tray menu or a shortcut a moment before.
- The tray countdown. The time left to a reset no longer shows "1h60m"; it shows "2h0m".
- Shortcuts with Shift only. A global shortcut needs Ctrl, Alt, Win or ⌘ now. A Shift-only shortcut such as Shift+A would have stopped you typing a capital A anywhere.
- Start at login. If the system refuses to add the app to startup (for example while it runs from the disk image), the switch now turns back off instead of staying on.
- A responsive window while Codex is checked. The window no longer freezes while the app checks the Codex installs it found, for example right after a Codex update.
- Telemetry and a busy port. If another program holds the telemetry port when the app starts, the app tries again for half a minute, then turns telemetry off and says why, so Claude Code stops sending to that program.
- PDF reports. A slow PDF that finished after its timeout could leave a stray file in your reports folder; reports are now printed in a private folder first. PDF errors now show a clear message instead of a code.
- Your own prices are saved safely. A price list you edit under Settings → Prices is written in one step, so a crash or a full disk can no longer wipe it.
- Daily export. Two project folders with the same name (for example two "api" folders) are now separate rows in a daily CSV or JSON export.
- More model names priced. Model names with a date such as
-2026-09-14now take the price of their base model.
Good to know
- No database change. Backups made with 0.8.2 can still be imported into 0.8.1.
- A held log is read on every scan. While a log holds records dated ahead of your clock, it is read again on each scan until the clock catches up. Records dated more than 30 days ahead count as damaged and are skipped.
Install
- Windows:
AI-Usage-Tracker_0.8.2_x64-setup.exe. No administrator rights are needed. The installer is not code-signed, so Windows may show "Unknown publisher". Choose More info → Run anyway. - macOS:
AI-Usage-Tracker_0.8.2_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_0.8.2_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_0.8.2_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_0.8.2_x86_64.AppImage(any distribution).
If you already use an earlier version, update from inside the app (Settings → Updates, the bottom left of the window, or the banner).
See the README for details, including how to uninstall on each system.
Verify a download: put SHA256SUMS next to the file and run sha256sum -c SHA256SUMS --ignore-missing (Linux) or shasum -a 256 -c SHA256SUMS --ignore-missing (macOS).
The .sig, .app.tar.gz, and latest.json files are used by the in-app updater; you don't need to download them.
Code signing policy: see CODE_SIGNING.md.