# Antigravity usage: a Hydrogen Widget

How much of your Antigravity quota you have used, in Hydrogen's Title Bar, next to Claude usage and Codex usage.

## What it shows

- **week**: the Gemini weekly limit, as percent used.
- **5h**: the Gemini five-hour limit, as percent used.
- Hover it for the bigger view: every limit Antigravity reports (the Gemini group and the Claude and GPT group), when each one resets on your clock, and your plan.

These are the numbers Antigravity's own **Settings, Models & Usage** page shows ("Weekly Limit Remaining", "Five Hour Limit Remaining"), turned into percent used so they read like the Claude and Codex widgets.

## Where the numbers come from

Antigravity's side-bar panel runs a local hub in your workspace (`agy --hub`). The widget finds that process, reads its port and CSRF token from its command line, and asks it for `RetrieveUserQuotaSummary`, the same call the Settings page makes. No model runs, so no quota is spent. If Antigravity is not open in this workspace, the widget says so: open the Antigravity panel once and it starts the hub.

## How often it asks

At most once every three minutes; it pauses while the Hydrogen window is hidden and retries at 5, 15 and 45 s on errors. Click the slot to cycle the views (numbers, rings, rows).

## Files

| file | role |
|---|---|
| `hydrogen-widget.json` | the manifest: id `antigravity-usage`, port 27020 |
| `bin/hydrogen-widget-antigravity-usage` | the data feed |
| `bin/hydrogen-widget-lib.py` | the shared page and layouts (from adom/adom-vscode's usage widgets) |
| `bin/hydrogen-widget-marks.py` | the Antigravity mark |
| `install.py` | links the feed into `~/.local/bin` |

Open it from the Hydrogen Widgets pulldown (the puzzle piece), or from an AI: `POST $ADOM_HD_CONTROL_URL/widgets/open {"id":"antigravity-usage"}`. How Hydrogen Widgets work: the `hydrogen-widget` skill.