QuotaBubble GitHub →

Your AI usage limits,
always in sight.

QuotaBubble is a tiny, always-on-top desktop bubble that shows the usage limits for your AI coding tools without opening a dashboard, terminal, or browser. It fades away when idle and expands when you click it.

Download for Windows, macOS, or Linux View on GitHub
Idle bubble Expanded detail

Features

Works with your tools

QuotaBubble reads the sign-in each tool already stores, so there is no QuotaBubble account and nothing extra to log into.

Hover, focus, or tap a tool to see where it reads from.

Tool icons on the website come from @lobehub/icons (MIT). All product names and logos belong to their respective owners and indicate compatibility only.

Install

Windows

Install from the Microsoft Store for a certified build with automatic background updates:

Get it from Microsoft Store

Or install with winget, built into Windows 10/11 and updated automatically with winget upgrade: 

winget install Izzet.QuotaBubble

Or install with Chocolatey: 

choco install quotabubble

Or with Scoop: 

scoop bucket add izzet https://github.com/izzet/scoop-bucket
scoop install izzet/quotabubble

Or download the portable QuotaBubble-windows-x64.zip from Releases, unzip it, and run QuotaBubble.exe.

The Microsoft Store package is certified with zero warnings. The standalone portable zip is unsigned for now, so Windows SmartScreen may ask you to choose “More info → Run anyway”.

macOS

With Homebrew, using the first-party tap (works on both Apple Silicon and Intel): 

brew install --cask izzet/tap/quotabubble

Or download the matching disk image from Releases: QuotaBubble-macos-arm64.dmg for Apple Silicon, or QuotaBubble-macos-x64.dmg for Intel. Open it and drag QuotaBubble to Applications.

The macOS builds are not yet Developer ID signed or notarized, so Control-click the app, choose Open, and confirm the dialog on first launch.

Ubuntu GNOME

Download QuotaBubble-linux-amd64.deb from Releases, then install it and enable the GNOME extension: 

sudo apt install ./QuotaBubble-linux-amd64.deb
gnome-extensions enable quotabubble@izzet.dev

Open quotabubble-settings to choose providers, notifications, and launch at login.

From source

With Python 3.11+ and uv: 

git clone https://github.com/izzet/quotabubble.git
cd quotabubble
uv tool install --editable .
quotabubble

Or install it as a standalone command with pipx: pipx install quotabubble.

FAQ

Does QuotaBubble send my data anywhere?

No. There is no QuotaBubble account, server, or telemetry. It only talks to the service each login belongs to, over HTTPS, to read your own usage numbers. The details are in the privacy policy. Read the privacy policy.

Why does it read my sign-in files?

To ask each service for your usage, it reuses the sign-in your tool already stored: a file in your home folder or an entry in the OS keychain or credential store. It never modifies or copies those files, only reads the tools you have enabled, and the whole app is open source so you can check.

Why does Windows or macOS warn me when I open it?

The standalone ZIP and DMG builds are not code-signed yet. On Windows choose “More info → Run anyway” in SmartScreen, and on macOS Control-click the app, choose Open, and confirm. If you install from the Microsoft Store on Windows, it is certified and signed with zero warnings.

My provider isn't showing up. What do I do?

Sign in to that tool first (Claude Code, Codex, Cursor, and so on), then open Settings and enable it. Providers that use an API key, like DeepSeek, OpenRouter, and Z.ai, need the key entered in Settings, and the Test button checks it. If it still fails, Open logs from the tray menu shows what went wrong, with secrets redacted.

How often does it update, and what if I'm offline?

Every 5 minutes by default, configurable in Settings. If a refresh fails because of a network or rate-limit error, it keeps showing the last good values, dimmed, and tries again on the next refresh.

Which systems does it run on?

Windows and macOS (Apple Silicon and Intel), plus Ubuntu GNOME through a package with a GNOME extension. You can also run it from source with Python 3.11 or newer, though other setups aren't tested.