AI Usage Bar 0.11.0

A "too many requests" from a service no longer takes its meter away for 10 minutes: the last numbers stay, with a short notice, and the app asks again after a minute.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin)
• Linux (x86_64): AIUsageBar-Linux-x86_64.AppImage, or AIUsageBar-Linux-x64.tar.gz (one executable, for machines without FUSE)

If you have 0.8.0 or newer, the app offers this update by itself: click Update in the popup, or use ⚙ → Check for updates. A portable Windows .exe from 0.9.1 or older won't offer it: install with AIUsageBar-Windows-Setup.exe instead.

What's new (the same on macOS, Windows and Linux)

• Rate limits. When a service answers "too many requests" (HTTP 429), the popup says "Too many refreshes in a row. Hang on a moment: trying again in 1 min." instead of showing an error, and the last numbers stay in the menu bar, the tray and the popup. The app asks again by itself after 1 minute: 2, 4, 8 and at most 10 minutes if it keeps happening, or the server's Retry-After when it sends one. Before, it waited a fixed 10 minutes.
• No more piling up. During that wait, opening the popup or clicking refresh no longer asks the agent that is waiting. That used to hit the server again and restart the 10 minutes. The other agents refresh as usual.
• Fresher numbers while you look. Opening the popup refreshes the agents not checked in the last minute, and it keeps refreshing every minute while it stays open. In the background it is still every 3 minutes.
• GitHub Copilot: a rate limit that GitHub answers with 403 now shows as a rate limit instead of "The server rejected the current login".

First launch

• macOS: the app is not signed by Apple yet, so macOS blocks it the first time. On macOS 15 or later, click Done on the warning, then open System Settings → Privacy & Security and click Open Anyway. On macOS 13–14, right-click the app → Open. Updates installed from inside the app do not ask again. If you use Cursor or Grok Bot, choose "Always Allow" when macOS asks for "Cursor Safe Storage" or "Grok Bot Safe Storage". macOS asks again after each update.
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet).
• Linux: make the AppImage executable (chmod +x, or Properties → Allow executing) and run it. It adds itself to the app menu.

Known limits

• Cursor on Windows and Linux probably encrypts its login too, and the app can't read it there yet, so the tab may still show a rejected login. If it does, please open an issue with the output of AIUsageBar --dump --raw, which prints no tokens.
• The Cursor, Codex, Copilot and Gemini endpoints are unofficial.

Independent project, not affiliated with Anthropic, OpenAI, GitHub/Microsoft, Google, xAI/SpaceXAI or Anysphere (Cursor).

AI Usage Bar 0.10.1

The Cursor tab now works on the Mac with current versions of Cursor.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin)
• Linux (x86_64): AIUsageBar-Linux-x86_64.AppImage, or AIUsageBar-Linux-x64.tar.gz (one executable, for machines without FUSE)

If you have 0.8.0 or newer, the app offers this update by itself: click Update in the popup, or use ⚙ → Check for updates. A portable Windows .exe from 0.9.1 or older won't offer it: install with AIUsageBar-Windows-Setup.exe instead.

What's new

• Cursor on macOS. Recent versions of Cursor keep the login encrypted, so the Cursor tab only showed a rejected login. The app now decrypts it with the key in the Keychain item "Cursor Safe Storage", the same way it already does for Grok Bot. Checked against a real Pro+ account: the plan, the Monthly, Auto and API usage, the reset date and the included spend match Cursor's own Usage screen. Thanks to @Fredbnm (#9).
• Windows and Linux: no changes besides the version number.

First launch

• macOS: right-click the app → Open (not signed by Apple yet). If you use Cursor or Grok Bot, choose "Always Allow" when macOS asks for "Cursor Safe Storage" or "Grok Bot Safe Storage". macOS asks again after each update.
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet).
• Linux: make the AppImage executable (chmod +x, or Properties → Allow executing) and run it. It adds itself to the app menu.

Known limits

• Cursor on Windows and Linux probably encrypts its login too, and the app can't read it there yet, so the tab may still show a rejected login. If it does, please open an issue with the output of AIUsageBar --dump --raw, which prints no tokens.
• The Cursor, Codex, Copilot and Gemini endpoints are unofficial.

Independent project, not affiliated with Anthropic, OpenAI, GitHub/Microsoft, Google, xAI/SpaceXAI or Anysphere (Cursor).

AI Usage Bar 0.10.0

Cursor joins the meter, and AI Usage Bar now runs on Linux.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin)
• Linux (x86_64): AIUsageBar-Linux-x86_64.AppImage, or AIUsageBar-Linux-x64.tar.gz (one executable, for machines without FUSE)

If you have 0.8.0 or newer, the app offers this update by itself: click Update in the popup, or use ⚙ → Check for updates.

On Windows, releases no longer include the portable .exe, so a portable copy won't offer this update. Install with AIUsageBar-Windows-Setup.exe instead; from then on, updates come by themselves.

What's new

• Cursor. A new tab for Cursor's legacy plans (Pro, Pro+, Ultra, Teams), which bill a monthly cycle:
  • Monthly: the cycle's included usage, plus the Auto and API pools, and when the cycle resets
  • how much of the included amount is spent, in dollars, plus bonus usage and on-demand spending
  • it reuses the Cursor editor's login, so there is nothing to set up
  • on the new X Subscription plans, the tab shows the weekly pool instead (the same one Grok Bot shows)
• Linux app. Each AI gets its own tray icon, with the same popup as on Windows. It comes as an AppImage or a portable executable, and updates itself. On GNOME, tray icons need the AppIndicator extension, which Ubuntu turns on by default.
• Dates for faraway resets. A limit that resets a week or more away shows the date instead of a weekday: "Resets Dec 8 at 12:00 AM · in 27 d 11 h". This also helps Copilot's monthly limit.
• Windows: releases carry only the installer.

First launch

• macOS: right-click the app → Open (not signed by Apple yet). If you use Grok Bot, choose "Always Allow" for "Grok Bot Safe Storage". macOS asks again after each update.
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet).
• Linux: make the AppImage executable (chmod +x, or Properties → Allow executing) and run it. It adds itself to the app menu.

Known limits

• The Cursor endpoint is unofficial. It has only been tested against sample data, because no Cursor account was available while writing it. If the Cursor tab shows an error, please open an issue with the output of AIUsageBar --dump --raw, which prints no tokens.
• The Codex, Copilot and Gemini endpoints are also unofficial and only tested against sample data.
• The Linux app has run on CI and on a virtual desktop, but not yet on a real GNOME or KDE desktop with real logins. Please report anything odd.

Independent project, not affiliated with Anthropic, OpenAI, GitHub/Microsoft, Google, xAI/SpaceXAI or Anysphere (Cursor).

AI Usage Bar 0.9.1

A friendlier installer on the Mac.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin) or AIUsageBar-Windows-Portable.exe (runs without installing)

If you have 0.8.0 or newer, the app offers this update by itself: click Update in the popup, or use ⚙ → Check for updates.

What's new

• macOS: the .dmg now opens on a window that shows what to do. The app and the Applications folder sit side by side with an arrow between them, and a note at the bottom explains how to open the app the first time. The mounted disk also shows the app's icon.
• Windows: no changes besides the version number.

First launch

• macOS: right-click the app → Open (not signed by Apple yet). If you use Grok Bot, choose "Always Allow" for "Grok Bot Safe Storage". macOS asks again after each update.
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet).

Independent project, not affiliated with Anthropic, OpenAI, GitHub/Microsoft, Google, xAI/SpaceXAI or Anysphere (Cursor).

AI Usage Bar 0.9.0

Choose what each tab shows, see every AI on one screen, and no more agents you don't use.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin) or AIUsageBar-Windows-Portable.exe (runs without installing)

If you have 0.8.0, the app offers this update by itself. Click Update in the popup, or use ⚙ → Check for updates.

What's new

• Pick the number on each tab. Go to ⚙ → the AI → In its tab, or right-click the tab. Highest usage stays the default. You can pin any one of that AI's limits instead:
  • Claude: weekly for all models, or for one model
  • Codex: session
  • Copilot: monthly requests
  • Gemini: one model's daily quota
• All AIs together. Under ⚙ → Popup, choose between one tab per agent and every AI on a single screen. If they don't fit, the list scrolls.
• Only the agents you use. An agent now shows up once its usage actually loads. A login without a plan behind it no longer appears with a warning; for example, the gh CLI signed in on an account without Copilot. Those agents are listed in the ＋ tab as "Login found, but no usage data". Tick Show to track one anyway.
• Gear menu. Each AI has its own submenu, holding what it shows in the menu bar (the tray on Windows) and in its tab.

First launch

• macOS: right-click the app → Open (not signed by Apple yet). If you use Grok Bot, choose "Always Allow" for "Grok Bot Safe Storage". macOS asks again after each update.
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet).

Known limits

• The Codex, Copilot and Gemini endpoints are unofficial and only tested against sample data.
• The Windows app has been tested on CI machines but not yet on a user's PC. Please report anything odd.

Independent project, not affiliated with Anthropic, OpenAI, GitHub/Microsoft, Google, xAI/SpaceXAI or Anysphere (Cursor).

AI Usage Bar 0.8.0

The app now updates itself.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin) or AIUsageBar-Windows-Portable.exe (runs without installing)

What's new

• In-app updates. The app looks for a new release when it starts and every 6 hours. When there is one, the popup shows New version … → Update: one click downloads it, installs it over the current copy and reopens the meter. To check right away, use ⚙ → Check for updates, which also shows the version you are running.
  • macOS: the app replaces itself where it is, usually Applications. Before swapping, it checks that the download is this same app, at the announced version, with an intact signature.
  • Windows: an installed copy runs the new Setup silently and keeps your "Start with Windows" choice. The portable .exe replaces itself in its folder.
  • Only files from this repository's releases are downloaded. The check sends nothing about you or your usage.

Updating to this version
Versions 0.7.0 and earlier cannot update themselves, so download 0.8.0 by hand once. From here on, new versions arrive through the app.

First launch

• macOS: right-click the app → Open (not signed by Apple yet). If you use Grok Bot, choose "Always Allow" for "Grok Bot Safe Storage". macOS asks again after each update.
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet). Updates installed by the app do not trigger SmartScreen.

Known limits

• The Windows updater has been tested on CI machines, both portable and installed, but not yet on a user's PC. Please report anything odd.
• The Codex, Copilot and Gemini endpoints are still unofficial and only tested against sample data.

Independent project, not affiliated with Anthropic, OpenAI, GitHub/Microsoft, Google, xAI/SpaceXAI or Anysphere (Cursor).

AI Usage Bar 0.7.0

Three more agents, one tab per agent, and a taskbar widget on Windows.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin) or AIUsageBar-Windows-Portable.exe (runs without installing)

What's new

• Codex (session and weekly), GitHub Copilot (monthly premium requests) and Gemini CLI (daily quota per model), on macOS and Windows. Each one shows up only if it is already signed in on the computer.
• One tab per agent in the popup, each with its official icon and its fullest limit. The ＋ tab lists every supported agent and how to connect the ones that are not signed in yet.
• Taskbar widget (Windows, optional): ⚙ → Taskbar widget → Show on the taskbar.

First launch

• macOS: right-click the app → Open (not signed by Apple yet). If you use Grok Bot, choose "Always Allow" for "Grok Bot Safe Storage".
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet).

Known limits

• The Codex, Copilot and Gemini endpoints are unofficial and have only been tested against sample data so far. Please report anything odd.
• Codex, Copilot and Gemini on macOS pass their tests and build on CI, but have not run on a real Mac with those logins yet.

Codex, Copilot, Gemini, the tabs and the widget were contributed by @tanure in #1. Thank you!

Independent project, not affiliated with Anthropic, OpenAI, GitHub/Microsoft, Google, xAI/SpaceXAI or Anysphere (Cursor).

AI Usage Bar 0.6.0

First release under the new name, and the first Windows build.

Downloads

• macOS 13+ (Apple Silicon and Intel): AIUsageBar-macOS.dmg
• Windows 10/11 (x64): AIUsageBar-Windows-Setup.exe (installs for your user, no admin) or AIUsageBar-Windows-Portable.exe (runs without installing)

What's new

• The Mac app is now AI Usage Bar (was "Claude Usage"). Settings carry over automatically.
• Windows app (C#/WPF): one tray icon per AI with a usage ring, and the same popup, options and English/Portuguese text as on macOS.
• Website with download links: https://matheusvelloso.github.io/ai-usage-bar/

First launch

• macOS: right-click the app → Open (not signed by Apple yet). If you use Grok Bot, choose "Always Allow" for "Grok Bot Safe Storage".
• Windows: if SmartScreen appears, click "More info" → "Run anyway" (not signed by Microsoft yet). New tray icons may start in the ^ overflow area.

Known limits

• The Windows build passes its tests and renders its popup on CI, but has not run on a real PC with real logins yet. Please report anything odd.
• Both apps rely on undocumented endpoints of Claude Code and Grok Bot, which may change.

Independent project, not affiliated with Anthropic, xAI/SpaceXAI or Anysphere (Cursor).