Quota Meter for Antigravity
A lightweight, zero-dependency VS Code extension that displays your remaining Google Antigravity (agy) model quotas — weekly and 5-hour windows per model pool — directly in the status bar.
Independent community project. Not affiliated with, endorsed by, or sponsored by Google.

Features
- Per-pool or compact status bar display with color-coded warning and error backgrounds when a pool runs low.
- Rich hover tooltip with colored, theme-aware progress bars per window (the time until reset is written on the bar), a status per pool (OK / LOW / CRITICAL / EXHAUSTED), local reset date/time, countdowns, models, exhaustion notes, and quick links to the Dashboard, Refresh and the Menu.
- Quick menu (
agyQuota.showMenu) with live-updating quota bars, one-click actions, and inline setting toggles.
- Dashboard tab (
agyQuota.openDashboard) with pool cards, SVG progress rings, per-bucket bars, model chips, and live countdowns.
- Low-quota & exhaustion notifications that fire once per reset cycle.
- Zero runtime dependencies — uses only Node.js built-ins.
Click a status bar item (with the default agyQuota.clickAction set to "menu") or run Antigravity Quota: Show Menu (agyQuota.showMenu) to open the quick menu at the top of the window:
- Quotas: Shows every pool (including hidden ones) with
progressBar meters per window, reset time, countdown, and models. Selecting a pool opens the Dashboard.
- Actions: Open dashboard, Refresh now, Copy summary as text, Show log, and Start agy Hub (when no hub is connected).
- Settings: Toggle 5-hour window, reset countdown, compact status bar, left/right alignment, per-pool visibility, status bar click action (
menu / dashboard), or update notification thresholds, warning/critical thresholds, and refresh interval directly without leaving the menu.

Dashboard
Run Antigravity Quota: Open Dashboard (agyQuota.openDashboard)—or set agyQuota.clickAction to "dashboard"—to open the theme-aware Antigravity Quota tab:
- Displays hub connection info (
127.0.0.1:<port> and lsVersion), last update time, and Refresh / Copy / Menu / Settings controls.
- Shows a responsive grid of pool cards with
OK / LOW / CRITICAL / EXHAUSTED badges, SVG quota rings, per-window horizontal bars, local reset times, live 30-second countdowns, disabled/exhausted notes, and model chips.
- Shows a clear error banner when a refresh fails while keeping the last known values, or an empty state with Start agy Hub when no hub is running.

Why Older Quota Extensions Broke (and How This Works)
With recent agy releases (hub lsVersion 2.3x, November 2026), older quota extensions stopped showing correct data for three reasons:
- CSRF token moved to
hub_<port>.json: The agy daemon now writes { pid, httpPort, httpsPort, lsVersion, csrfToken } into ~/.gemini/antigravity/daemon/hub_<port>.json and rejects requests without X-Codeium-Csrf-Token (401 missing CSRF token). Process command-line scraping alone misses the hub token.
- Stale hub files:
~/.gemini/antigravity/daemon/ often accumulates dozens of leftover hub_*.json files from exited sessions. This extension checks whether each pid is actually alive and sorts active hub files newest-first before connecting (falling back to process discovery only if no hub file works).
- Proto3 JSON omits zero values: When a quota window is exhausted (
0%), Proto3 JSON omits remainingFraction while keeping resetTime. Older extensions treated a missing fraction as 100% instead of 0%. Similarly, disabled buckets (such as a 5h window disabled while weekly is exhausted) are now shown as n/a and excluded from the binding calculation.
Requirements
- Google Antigravity (
agy) installed on your machine.
- A running
agy hub (started automatically when using agy, or via Antigravity Quota: Start agy Hub).
To start the hub manually from a terminal:
agy models
Settings
| Setting |
Type |
Default |
Description |
agyQuota.refreshIntervalSeconds |
number |
60 |
How often to poll the local agy hub for quotas (minimum 15 seconds). |
agyQuota.statusBarStyle |
"perPool" \| "compact" |
"perPool" |
Show one status bar item per pool (perPool) or a single combined item (compact). |
agyQuota.statusBarAlignment |
"right" \| "left" |
"right" |
Side of the status bar for the Antigravity items. |
agyQuota.statusBarPriority |
number |
97.5 |
Position within that side (higher = further left). Items use priority, priority − 0.01, … so they stay together. |
agyQuota.groupLabel |
string |
"AG" |
Label before the first item, marking the Antigravity group. Empty hides it. |
agyQuota.showFiveHour |
boolean |
true |
Show the 5-hour window next to the weekly window in perPool mode. |
agyQuota.showCountdown |
boolean |
true |
Show the time until each pool's binding (lowest) window resets. |
agyQuota.warningThreshold |
number |
30 |
Remaining percentage (0–100) at or below which the status bar uses the warning background. |
agyQuota.errorThreshold |
number |
10 |
Remaining percentage (0–100) at or below which the status bar uses the error background. |
agyQuota.notifyBelow |
number |
20 |
Show a warning notification once per cycle when a window drops to or below this % (0 disables). |
agyQuota.hiddenPools |
string[] |
[] |
Pool names (as shown in the tooltip, e.g. "Gemini 4 Argon") to hide from the status bar. |
agyQuota.agyPath |
string |
"agy" |
Path to the agy executable used by Start agy Hub. |
agyQuota.daemonDir |
string |
"" |
Custom folder for hub_<port>.json files. Empty uses ~/.gemini/antigravity/daemon. |
agyQuota.clickAction |
"menu" \| "dashboard" |
"menu" |
What clicking an Antigravity status bar item opens (menu or dashboard). |
Commands
Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and search for Antigravity Quota:
- Antigravity Quota: Refresh Now (
agyQuota.refresh) — Immediately fetch the latest quota snapshot.
- Antigravity Quota: Show Menu (
agyQuota.showMenu) — Open the quick menu with live quotas, actions, and inline setting toggles.
- Antigravity Quota: Open Dashboard (
agyQuota.openDashboard) — Open or reveal the interactive quota dashboard tab.
- Antigravity Quota: Show Details (
agyQuota.showDetails) — Alias of Show Menu.
- Antigravity Quota: Copy Summary as Text (
agyQuota.copySummary) — Copy a plain-text quota table to the clipboard.
- Antigravity Quota: Start agy Hub (runs
agy models) (agyQuota.startHub) — Launch the local agy hub and refresh.
- Antigravity Quota: Show Log (
agyQuota.showLog) — Reveal the Antigravity Quota output channel.
Privacy & Security
- Localhost only: Communicates exclusively with
127.0.0.1 (httpPort first, then httpsPort with local self-signed TLS allowed only on 127.0.0.1).
- Token handling: The
csrfToken is held in memory only for local request headers and is never stored, printed, copied, or written to logs or error messages.
- No telemetry: Sends zero external network requests or analytics.
Troubleshooting
- Status bar shows "⚠ Antigravity quota: no hub":
- Click the status bar item to run Start agy Hub, or run
agy models in a terminal.
- If
agy is not on your PATH, set agyQuota.agyPath to the full path of the executable (on Windows the default install location %LOCALAPPDATA%\agy\bin\agy.exe is tried automatically).
- Items mix with another extension's items (e.g. Claude Code Usage): VS Code orders status bar items only by priority and cannot be reordered by dragging. This extension keeps its items together with fractional priorities; change
agyQuota.statusBarPriority (e.g. 150 to move the group further left) or agyQuota.statusBarAlignment. Right-click the status bar to hide single items.
- A pool shows ⚠ instead of its icon: the hub stopped answering and the numbers are older than two refresh intervals. The tooltip says when they were last updated.
- Inspecting connection details:
- Run Antigravity Quota: Show Log to see discovered hub files, PIDs, ports, schemes, server versions, and HTTP statuses.
Installation
The extension is not in a marketplace yet. Download antigravity-quota-meter-<version>.vsix from the
latest release (or build it, see below) and install it:
- VS Code / Antigravity IDE: Extensions view →
… → Install from VSIX…, or
code --install-extension antigravity-quota-meter-<version>.vsix
Then run Developer: Reload Window.
Development
Requires Node.js 20+.
npm ci
npm test # compile + unit tests (node:test)
npm run cli # print the live quota table from the local agy hub
npm run package # build antigravity-quota-meter-<version>.vsix
src/hub.ts, src/client.ts, src/normalize.ts and src/tooltip.ts have no VS Code dependency and are unit-tested.
scripts/hover-check.js (Windows) starts a throwaway VS Code with the extension, hovers the status bar item through the Chrome DevTools Protocol and saves a screenshot of the real tooltip, so tooltip changes can be checked in dark and light themes.
scripts/screenshots.js (Windows) takes the README screenshots the same way.
docs/ holds the implementation specs of 0.1 and 0.2.
License
MIT
| |