Repository navigation
Releases
AI Usage Tracker 1.2.0
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.
AI Usage Tracker 1.1.0
1.1.0 gives you more to share: week, calendar, hours and year-story cards in four sizes and four themes, with badges and the change from the period before.
What's new
- A week on a card. The Summary cards page now has Week next to Day, Month and Year. Weeks run from Monday to Sunday.
- Three new cards.
- Calendar (month or year) colors every day by how much you used it, with your active days and your longest streak.
- Hours shows when in the day you work around a 24-hour dial. The six hours that hold most of your use get a name, such as Night owl for 23:00–05:00. Longer periods also show your week hour by hour.
- Year story turns your year into story slides: the totals, the calendar, your hours, your models and your badges.
- Four sizes. Every card comes as a 1080 × 1920 story, a 1080 × 1080 square, a 1200 × 675 landscape image for X or LinkedIn, and a wallpaper the size of your screen.
- Four themes and an accent color. Choose navy, light, sunset or aurora, and one of six accent colors.
- Badges. A card marks the fixed thresholds the period reached:
- 100 million, 1 billion or 10 billion tokens
- a 7-, 30- or 100-day streak
- use on every day of a finished week or month
- 2×, 5× or 10× the plan price
- an 80%, 90% or 95% cache hit rate
- 2, 3 or 4 tools used together
- Change from the period before. Summary cards show how your tokens compare with the period before. A period still running is compared with the same days and time of the one before. The change is left out when your archive does not reach back that far.
- Tool shares. Summary cards show each tool's share of your tokens.
- Choose what a card shows. Show on the card leaves out the API-equivalent cost, the plan value, the change, tool shares, model names or badges. Your choices are kept.
- Copy or save everything at once. Copy puts a card on the clipboard, ready to paste into a post or a chat. Save all four sizes and Save all slides save into one folder. A file already there is never replaced; the new one gets a numbered name.
Fixes
- The Summary cards title has room above it. It no longer sits against the top of the window.
Good to know
- No database change. Backups made with 1.1.0 can still be imported into 1.0.0.
- On Linux, a copied card stays on the clipboard while the app is running.
- Cards hold totals, tool names and model names only. They never show project names or anything you wrote.
Install
- Windows:
AI-Usage-Tracker_1.1.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.1.0_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_1.1.0_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_1.1.0_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_1.1.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.
AI Usage Tracker 1.0.0
1.0.0 is the first stable release: follow a session request by request, keep a monthly budget, find anything with one shortcut, and share a day, month or year of your use as an image.
What's new
- Session timeline. Open a session on the Sessions page to see each of its requests as a column: how large the context was, how much came from the cache, where the cache was written again after a pause, where the context shrank, which requests came from subagents and which tools were called. The session's numbers sit under the chart.
- Monthly budget. Set a monthly limit for the API-equivalent cost of every tool in Settings → Monthly budget. The Overview shows this month's spend, how much is left and, after the first days of the month, where you are heading at this pace. A notification tells you when you reach 80% and when you go over; turn it off in Settings → Notifications.
- Search everything. Press Cmd+K on a Mac or Ctrl+K on Windows and Linux, or click Search in the sidebar, to jump to any page, setting, project, model or session. You can also switch the theme, show or hide the widget, and check for updates from there.
- Summary cards. The new Summary cards page turns a day, a month or a year of use into an image: a 1080 × 1920 Instagram story and a 1080 × 1080 square, in navy or light. A card shows your tokens, the API-equivalent cost, what your plan was worth when its price is known, your busiest days, your longest streak, the cache hit rate and the model you used most. Save either one as a PNG. Cards hold totals and model names only, never project names or anything you wrote.
- Notifications you can check. Settings → Notifications → Test notification shows whether your system lets the app notify you, and tells you where to allow it if not. Clicking a limit notification opens the Limits page.
- Menu bar warnings without the square (macOS). Near and at a limit, the menu bar dial turns orange or red on its own, without a colored square behind it.
- CSV for Excel. Settings → Data → Export has a CSV (;) format with semicolons and a decimal comma, so Excel in languages such as Turkish or German opens it in the right columns.
Fixes
- Notifications on Linux stay on screen. GNOME removes an app's notifications as soon as the connection that sent them closes, so a notification could vanish before you saw it. The app now keeps one connection open for its notifications, and clicking one opens the app.
- Switching accounts is not a reset. Changing the Claude or Codex account in use no longer sends "your limit has reset" for a limit that has not. Limit notifications follow the account in use, so another account's limit starting again never reads as if yours were free.
- Read intervals stay as you set them. Changing how often two tools' limits are read, one right after the other, could briefly show the first one's old interval again on the Sources page.
- Prices follow the app's updates. A price list you saved once kept every price as it was that day, so later corrections never reached it. Now only the prices you change are kept, and every other model follows the app's list. Prices can also change on a set date: Gemini 3.6, 3.7 and 3.8 Flash keep their introductory price for 2026 and take the regular one from 2027-01-01, without repricing your earlier use.
- Use of an unidentified account is not "use from elsewhere". With several Claude or Codex accounts, requests no evidence ties to an account no longer make a limit's rise look like use from the web or another computer; on the Limits page they get a share of their own. A reading taken before such requests is no longer shown as current.
- OpenCode tool calls are counted once. A tool call read while its input was still streaming was stored twice.
- "Try again" tells the truth. When Claude's 5-minute rule blocks the read, the app now says the read will come in a few minutes instead of reporting the limits as read.
- The widget leaves the keyboard alone (macOS). Saving a setting no longer makes the widget the active window, so typing on the Menu bar page and ⌘W go to the dashboard.
- Long periods stay responsive. While a tool is writing, a period of six months or more refreshes at most every 15 seconds instead of reading the whole archive again every second or two.
- One notification when a reset time moves. If a full limit's reset time moves without the limit resetting, you no longer get "has reset" and "is full" at once.
- An outdated reading looks outdated on the tray icon. When a limit was used after its newest reading, the icon's number or dial is drawn faded, as the menu bar text marks it with "~". On Windows the icon is the only place that shows it.
- A window the provider stopped reporting goes away. Claude no longer reports a separate Opus week; once such a window is over and a newer read leaves it out, its card leaves the Limits page instead of staying as "reset".
- A conversation that moved is followed (Antigravity). When the same conversation exists in more than one Antigravity folder, the copy written last is read, so one that goes on in its new place keeps counting.
- Changing the hotkey leaves nothing behind (Linux). Each change used to keep an old listener and its connection to the desktop open.
- Keyboard and screen reader access. The session timeline's columns can be stepped through with the arrow keys, and each request is read out; the search list groups its results so screen readers announce them, and an empty search is announced.
- File names get their extension. The PDF summary, exports and backups ask again with the extension when the save dialog leaves it off, and the PDF summary is only saved as a
.pdf.
Good to know
- No database change. Backups made with 1.0.0 can still be imported into 0.9.0.
- Tighter window permissions. The widget, the tray panel and the hidden PDF page may now only listen to the app's events and size or move their own window; only the dashboard has the wider access.
- Linux and Windows notifications are built and checked automatically, but clicking them was tested by hand only on a Mac. Please report anything odd.
Install
- Windows:
AI-Usage-Tracker_1.0.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.0.0_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_1.0.0_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_1.0.0_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_1.0.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.
AI Usage Tracker 0.9.0
Notifications tell you when a limit gets close, fills up and starts again, buttons use the app's own blue, and on a Mac the widget can stay over full-screen apps.
What's new
- Limit notifications. A system notification tells you when a limit you use passes your warning threshold, when it fills up, and when a full limit starts again. It shows when the limit resets and, at your current pace, roughly when it fills. Choose what you get in Settings → Notifications: an early warning at the Caution or Critical threshold (or none), a notice when a limit fills up and when it resets, for 5-hour and weekly limits separately. On a Mac, macOS asks once whether the app may send notifications. Opening the app never reports what happened while it was closed.
- Buttons in the app's blue. Buttons and selected items now use the app's own blue on every system. To keep your system's accent color, choose Settings → Accent color → System color.
- The widget over full-screen apps (macOS). With Settings → Show in the Dock off, the widget can stay over full-screen apps. Hide during full-screen apps in the Widget studio and the widget's menu now works on a Mac too: leave it on to hide the widget there, or turn it off to keep it in view.
Good to know
- No database change. Backups made with 0.9.0 can still be imported into 0.8.5.
Install
- Windows:
AI-Usage-Tracker_0.9.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_0.9.0_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_0.9.0_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_0.9.0_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_0.9.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.
AI Usage Tracker 0.8.5
The menu bar icon can show your limit as a live dial, Claude accounts are noted reliably, and Windows gets a tray mark made for its taskbar.
What's new
- A dial in the menu bar. On the Menu bar page, under Icon, Show in the icon now offers Usage dial: the app's dial with its arc filled to the limit you chose and its needle pointing at the value. On a Mac it is a plain mark that follows the menu bar's light or dark look; past the warning threshold it turns amber, and red when the limit is full. On Windows and Linux it sits on the app icon's navy square.
- A tray mark for the Windows taskbar. When the tray shows the app icon, Windows now shows a mark drawn for a light or a dark taskbar, at the size your screen needs. Change the taskbar's theme and the mark follows within seconds.
Fixes
- Claude accounts noted reliably. Every 30 seconds the app notes which account each Claude config folder is signed in to. If the app was storing new usage at that moment, the note could fail with "database is locked" and was lost, so with more than one account some requests could stay under Unidentified account. The note now waits its turn.
Good to know
- No database change. Backups made with 0.8.5 can still be imported into 0.8.4.
Install
- Windows:
AI-Usage-Tracker_0.8.5_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.5_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_0.8.5_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_0.8.5_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_0.8.5_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.
AI Usage Tracker 0.8.4
A new app icon, a menu bar panel that opens under its icon on every screen with clearer buttons, and on a Mac a switch to keep the app out of the Dock.
What's new
- A new icon. The app has a new icon on every system: a usage dial whose needle is the AI sparkle, and whose blue arc is the share of your limit already used. On a Mac, when the menu bar shows the app icon instead of a percentage, it is now a plain mark that follows the menu bar's light or dark look.
- Colors to match. The app's grays now lean slightly blue in both light and dark mode, and charts use the icon's blue. Buttons still follow your system's accent color on Windows and macOS.
- Keep the app out of the Dock (macOS). Turn off Settings → Show in the Dock and the app leaves the Dock and the ⌘Tab list. Open it from its menu bar icon or the widget shortcut. Your open windows stay open when you switch it.
- Clearer panel buttons. The buttons at the bottom of the control panel now fill their tiles like the other tiles, with new filled icons for opening the app, the widget, scanning and settings. The Menu bar page's gallery shows the same icons.
Fixes
- The panel on a second screen. With two screens of different scale (for example a Retina laptop and a regular monitor), the control panel could open in the middle of the other screen. It now opens under the menu bar icon you clicked, on that screen.
- The update banner. On pages with their own title (Limits, Sources, Widget studio, Menu bar), the update banner no longer sits against the top edge of the window.
- No more bare error page. After a window was closed, it could come back showing only "only POST and OPTIONS are allowed". The app's windows now open only the app's own pages; anything else is refused and the window stays where it was.
Good to know
- No database change. Backups made with 0.8.4 can still be imported into 0.8.3.
Install
- Windows:
AI-Usage-Tracker_0.8.4_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.4_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_0.8.4_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_0.8.4_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_0.8.4_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.
AI Usage Tracker 0.8.3
The menu bar icon can show the logo of Claude, Codex, Antigravity or OpenCode in the tool's own color, and the Limits page helps you find a Claude account the app could not see.
What's new
- A tool's logo in the menu bar. On the Menu bar page, under Icon, Show in the icon now offers the Claude, Codex, Antigravity or OpenCode logo, or the logo of the tool whose limit is shown, besides the percentage and the app icon. The square still turns amber or red as that limit fills. On macOS and Linux you can keep the percentage in the text next to the icon; on Windows, hover the icon to see it.
- The tool's own color. Turn on Color the square like the tool and the square takes the tool's color: Claude orange, Codex green, Antigravity blue, OpenCode gray, or the color you chose under Settings → Tool colors. It still turns amber or red when the limit passes its warning threshold. This works with the percentage too.
- The preview shows the real icon. The preview on the Menu bar page now draws the icon as your menu bar or tray will show it, in the same colors.
- A Claude account the app could not see. If the app knows one Claude account and your Claude weekly window started again days before it was due to end, the Limits page says so. This usually means another account was used before the app could tell your accounts apart. How shows the steps to make that account visible: switch to it with
/login, wait for one limit read, then switch back.
Good to know
- No database change. Backups made with 0.8.3 can still be imported into 0.8.2. If you go back to an earlier version, the icon shows the percentage again.
- The note can follow an early reset. If Anthropic resets your weekly limit early and moves its reset day, the note may appear with a single account too. You can ignore it then; it goes away two weeks later.
Install
- Windows:
AI-Usage-Tracker_0.8.3_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.3_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_0.8.3_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_0.8.3_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_0.8.3_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.
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.
AI Usage Tracker 0.8.1
Each Codex and Claude account now has its own plan, plan advice and share of plan value, and you can choose how often limits are read.
What's new
- A plan for each account. If you use more than one Codex or Claude account, choose each account's plan and price on the Limits page. An account without a choice takes the plan its limit readings name. Claude's readings do not tell Max 5x from Max 20x, or Team Standard from Team Premium, so such an account takes the plan you chose for Claude, or asks you to choose. A price you enter for an account applies to that account's plan only.
- Plan advice for each account. Tips gives each account its own plan recommendation, built on its own limit windows and plan. If one account keeps filling its limits while another has room, the page says so.
- Plan value adds up your plans. On the Overview, Plan value now counts each account with its own plan and price and adds the prices together. It lists each account's API-equivalent use next to its plan, and leaves out use on a free plan or at API rates. The Usage summary (PDF) does the same.
- Choose how often limits are read. Under Sources → Live capture, each limit read has a How often setting: Codex and Antigravity from every minute to every hour, Claude from every 5 minutes to every hour (Claude's usage service does not answer more often).
Fixes
- The menu bar number keeps one size. A one-digit percentage in the menu bar (and the Windows tray) is now as large as a two-digit one.
- Panel tiles no longer touch their edges. Wide tiles with a title and two bars, and the ring tiles, now keep even space above and below.
- Codex Team readings. Codex readings that name the plan "team" now count for Business / Team.
- A week read on two plans. If your plan changed in the middle of a weekly window, that window no longer counts as full for the new plan in the plan recommendation.
- Prices left from another plan. A free or API plan no longer takes a price you entered earlier for another plan.
Good to know
- With one account, nothing changes. The plan you chose for the provider applies as before.
- Unidentified use counts only toward the total. Plan value adds use that no evidence ties to an account to the total, not to any one account, so an account's own figure can look lower than it is.
- Max and Team accounts may ask for their plan. If the plan you chose for Claude is not a Max or Team plan, a Max or Team account shows Choose a plan on the Limits page until you pick one.
Install
- Windows:
AI-Usage-Tracker_0.8.1_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.1_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_0.8.1_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_0.8.1_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_0.8.1_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.
AI Usage Tracker 0.8.0
Each Codex and Claude account now gets its own limits, history and forecast, and OpenCode joins the widget, the panel and the menu bar.
What's new
- More than one Codex account. If you switch between Codex accounts, each account now has its own limits, history and forecast. The app ties a request to an account only by what Codex records for certain: the account that started a session (Codex 0.157 and later), the signed-in account in the limit read (Codex 0.163 and later) and the limit window each request reports. An early reset, including one the provider grants, is not mistaken for an account switch.
- More than one Claude account. Each Claude plan organization counts as an account, so a Team plan you use with the same login gets its own limits too. The app learns the account from Claude Code's telemetry while the local telemetry receiver is on, from the sessions the Claude desktop app runs in its Code tab, and from a config folder that stayed signed in to one account the whole time the app watched it, as with one
CLAUDE_CONFIG_DIRper account. If you switch accounts in the same folder, turn on the local telemetry receiver. - Nothing is guessed. A request without such evidence stays under Unidentified account instead of being counted for one of your accounts. With a single account, nothing changes.
- Name your accounts. The Limits page shows every account, and you can give each one a name there. Usage, limit history and a day's details can be filtered by account.
- Your other accounts beside the one in use. The widget, the control panel and the menu bar text show the account in use. Add your other accounts next to it in the Widget studio or from the item lists on the Menu bar page.
- OpenCode on the widget, the panel and the menu bar. Show OpenCode's usage on its own next to your limits: on the widget, as a panel tile, or in the menu bar text.
- Use from elsewhere on its own row. On Limits, the part of a limit used while this computer sent no request, such as on the web, a phone, in cloud tasks or on another computer, now shows as Not in local logs instead of being charged to your projects.
- GPT-6.1 Terra prices. GPT-6.1 Terra is priced, including its higher rate for prompts over 272K tokens and Fast mode.
Fixes
- Compressed Codex sessions. Newer Codex versions compress older sessions (
.jsonl.zst), and their usage and limits were missed. They are read now. - The newest Codex reads your limits. If more than one Codex is installed, such as the one inside the ChatGPT app on macOS, limits are read through the newest one.
- An older reading shows "~". When you used a tool after its newest limit reading, the panel and the menu bar text showed that reading with "≥". A reset the provider grants in between can make the real value lower, so it now shows "~".
- Forecasts after an early reset. If the provider resets a window early without moving its end, the forecast and the time a limit spent full are now measured from that reset.
- Unpriced models in the widget. When one tool used a model without a price, every tool's cost in the widget's per-tool split showed "≥". Now only that tool's cost does.
- No text selection in the widget and the panel. Clicking or dragging there no longer selects text.
Good to know
- The first start takes longer. The app reads your Codex logs again once, to learn each request's limit window and account.
- Backups: a backup made with 0.8.0 cannot be imported into 0.7.1 or earlier.
- Older requests may stay unidentified. Codex before 0.157 does not record the account that started a session, so its requests are tied to an account only through a limit window known to be that account's. Claude requests from before the app watched your sign-in are tied only when telemetry or the Claude desktop app names their account.
- Your plan is still set per provider. Plan value counts all your accounts of a provider against the one plan you chose.
- Tool calls are filtered by session. If two accounts sent requests in the same session, that session's tool calls count for both when you filter by account.
Install
- Windows:
AI-Usage-Tracker_0.8.0_x64-setup.exe. No administrator rights are needed. The installer is not code-signed yet, so Windows may show "Unknown publisher". Choose More info → Run anyway. - macOS:
AI-Usage-Tracker_0.8.0_universal.dmg. Drag the app to Applications and open it from there. - Linux:
AI-Usage-Tracker_0.8.0_x86_64.deb(Debian, Ubuntu),AI-Usage-Tracker_0.8.0_x86_64.rpm(Fedora; on openSUSE add--allow-unsigned-rpm), orAI-Usage-Tracker_0.8.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.