Repository navigation
1.2.0 brings notifications to Windows, tells you when a tool needs a sign-in, and gives session details a clearer layout.
What's new
- Sign-in notifications. When Claude Code, the Codex CLI or the Antigravity CLI is signed out and your limits cannot be read, a notification tells you once. Click it to see how to sign in. Turn it off with Settings → Notifications → When you need to sign in.
- Clearer session details. A row on the Sessions page now opens into one panel: input, cache reads and writes, output, average context and cache hit rate side by side, the models under them, then the tool and the session ID with a copy button.
- Turn off the arc on a card. Show on the card → Active days arc removes it from story and square cards.
Fixes
- Notifications on Windows. Installs updated from an early version kept an old app ID on their Start menu shortcut, and Windows drops notifications for an ID it does not know. An update now repairs the shortcut and registers the app's name and icon. If notifications are turned off for the app in Windows, Test notification tells you where to turn them on.
- Antigravity sign-outs are recognized. The app now reads what the Antigravity CLI says when it needs a sign-in, so the sign-in steps appear when they should.
- A failed limit read is no longer called a sign-out. No network, an answer this version does not recognize, or an API key each get their own message under Sources → Live capture.
- An old limit reading no longer hides a sign-out. Only a reading from the last 15 minutes counts as proof that your limits still arrive.
- The Daily calendar shows the last month's name in full. It is no longer cut off, and it also appears when the range ends on the first day of a month.
- Long model names fit in session details. A long name is shortened, so its requests, tokens and cost stay in view. Hover over it to see the full name.
- Event times stay on one line. With a 12-hour clock, the times in a session's event list no longer wrap.
Fixes to 1.1.0
- The arc on a card stays clear of the title. It is also shorter, and its fill now shows your share of active days across the part you can see.
- A batch save leaves no broken image. A card gets its file name only when it is finished, so a save that is cut off short leaves nothing under that name.
Good to know
- No database change. Backups made with 1.2.0 can still be imported into 1.1.0.
- A sign-in notification can come right after the app opens. A sign-out is something to act on now, so unlike a limit notification it is not held back at the start.
- Windows notifications use the app's Start menu shortcut. An update repairs it. If you deleted the shortcut, run the installer again to get it back.
- If you use Claude Code through the API, choose API (pay as you go) as your Claude plan in Settings. The app cannot always tell such a sign-in from an expired one, and this choice keeps the sign-in notification off.
Install
- Windows:
AI-Usage-Tracker_1.2.0_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_1.2.0_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_1.2.0_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_1.2.0_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_1.2.0_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.