Antigravity Usage

June 14, 2026 · View on GitHub

A DMS (Dank Material Shell) plugin that monitors your Google Antigravity (agy) usage directly from the taskbar — the shared 5-hour and weekly limits for the Gemini and Claude & GPT model groups, the same numbers shown on the CLI's Models & Quota page.

Antigravity Usage popout

Features

  • Taskbar pill with a circular progress ring showing your tightest (most-consumed) limit.
  • Popout with one card per model group (Gemini, Claude & GPT), each showing the Weekly and Five-Hour limit as a progress bar with used / left percentages and a live reset countdown.
  • Automatic sign-in detection — reuses the credentials the agy CLI already stored; no extra login.
  • Configurable refresh interval (2–15 minutes).
  • Localization (English and French).

How it works

agy stores its OAuth credentials in the OS keyring (libsecret: service gemini, account antigravity). The plugin reads that access token (refreshing it via the CLI's public OAuth client when expired — it caches the refreshed token under ~/.cache/agy-usage/ and never modifies the keyring), then queries the same Cloud Code backend the CLI uses:

POST https://daily-cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary

This endpoint is gated by User-Agent, so the script identifies as antigravity/cli/<version>.

Requirements

Installation

Clone into your DMS plugins directory as antigravityUsage:

git clone <repo-url> ~/.config/DankMaterialShell/plugins/antigravityUsage

Then enable it in DMS Settings (Mod + , > Plugins).

The popout alongside the agy CLI's own Models & Quota page:

Antigravity Usage in context

Credits

Built on the structure of the Claude Code Usage DMS plugin by Nicolas Bellamy (MIT). See LICENSE.