Repository navigation
1.3.0 tells you which account to continue with, counts down your Claude Code cache, measures plan value by your billing period, and keeps prices current without an update.
What's new
- Account suggestion. With more than one Claude or Codex account, the Limits page names the account to continue with when the one in use is full, or when another has at least 25 points more room. When a limit fills up, its notification names that account too. Turn it off for the page with Settings → General → Account suggestion, and for notifications with Settings → Notifications → Account suggestion.
- Cache time left. While your latest Claude Code conversation still has its cache, the widget counts down how long it has left ("Cache time left: 3:12"), and the menu bar shows it in minutes. Continue before it runs out and the next request reads the cache at the cheap price instead of writing it again. The widget and the menu bar each have their own switch in Settings → General.
- A notification before the cache runs out. Turn on Settings → Notifications → Before the cache runs out to hear about it 1 minute ahead for a 5-minute cache, or 5 minutes ahead for a 1-hour one. Click it to open the Cache page.
- Plan value by billing period. Enter the day your subscription renews on the Limits page, for the provider or for each account. The Plan value card then compares your use since the last renewal with the full monthly price. It also shows which day of the period you are on and how much more use it takes to reach the plan price.
- New prices without an update. At startup and every 12 hours, the app downloads the price list from GitHub and uses it when it is newer, so a new model is priced without a new version. Only that file is downloaded and nothing is sent. Turn this off with Settings → Prices → Keep the price list current, or check at once with Check prices.
- Your own price for any model. In Settings → Prices, type a price for a model the list does not have. It is marked yours, and no newer list changes it. A price you change is marked changed and goes back to the list price with one click.
- Fable 5.2 and Mythos 5.2. Both are priced at the official API list prices.
Fixes
- A five-hour limit no longer looks free while its week is full. It shows a lock and week full instead of a percentage, because none of it can be used until the week resets. The widget, the panel, the Limits page and the menu bar icon all show it this way. Claude's Opus and Sonnet weeks lock nothing, since other models stay free.
Good to know
- No database change. Backups made with 1.3.0 can still be imported into 1.2.0.
- The cache notification is off at first. A 5-minute cache would notify on every short pause.
- The account suggestion uses only current readings. An account without one is never suggested, and nothing is suggested while the account in use has none.
- Accounts with different renewal days each count from their own renewal, and the period shown ends at the first renewal. Use that no evidence ties to an account counts from the latest one. Until every account of a provider has a renewal day, its own or the provider's, the card keeps showing the last 30 days.
- A downloaded price list is used only when it holds every model the app knows. Prices you changed or typed in stay yours.
Install
- Windows:
AI-Usage-Tracker_1.3.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.3.0_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_1.3.0_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_1.3.0_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_1.3.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.