Docs · setup · Antigravity

Set up Antigravity

UsagePool reads an owner-only local projection file written by a signed helper. The tool needs to be installed and already authenticated on this Mac.

Prerequisites

macOS 13 Ventura or newer, on Apple silicon or Intel.
Google Antigravity CLI installed and signed in, for the experimental local quota projection.

What UsagePool does with Antigravity →

02 / 03 · Steps

Four steps to a live meter.

Step 1: Enable Antigravity on the first-launch provider screen and confirm the status-line change when asked. It is reversible.
Step 2: Use the official CLI until it emits a status-line quota payload — until then there is nothing to project.
Step 3: Choose Refresh. UsagePool rereads the local projection and lists the buckets it found.
Step 4: Choose gemini-weekly as a menu bar widget, then hover it to see the provider card.

Fast local checks identify which services are available before any authenticated tool, credential, subprocess or network request is used, so an unconfigured provider costs nothing.

03 / 03 · When it fails

Honest failure modes.

These are the ones you will actually hit, and what each one means.

Antigravity is connected but has no meters.

Use the official CLI until it emits a status-line quota payload, then choose Refresh. Refresh rereads the local projection and does not force a backend quota update.

You are looking for Gemini CLI usage.

Google retired Gemini CLI for individual and consumer accounts in June 2026. Use the Antigravity provider; its gemini-weekly meter covers Gemini-model quota for Antigravity accounts.

A bucket you expected is missing.

A bucket is rejected only when nothing usable survives — no positive reset window, or no readable name. Everything else becomes a bounded, labelled card.

Still stuck: known issues lists the constraints that are not bugs, and [email protected] reaches a person.