Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>AG UsageNew to Visual Studio Code? Get it now.
AG Usage

AG Usage

Cristian Militaru

|
543 installs
| (0) | Free
Track usage of Antigravity AI models
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

🚀 AG Usage

Real-time usage tracking for Antigravity AI models

VS Marketplace Version VS Marketplace Downloads Open VSX Version Open VSX Downloads
GitHub GitHub Stars License Donate


✨ Features

  • Webview panel: Includes a dashboard showing your current model quotas, Extra Credits, reset timeline, most used models, StatusGator public health information, an interactive usage history log with trend sparklines, and a usage activity heatmap with monthly navigation.

    AG Usage Dashboard Panel Preview

  • Customizable dashboard layout: Reorder or hide dashboard sections using the layout edit mode in the dashboard title bar or via extension settings.

  • Reset timeline: Displays a visual timeline of upcoming weekly quota resets across days.

    AG Usage Reset Timeline Preview

  • Status bar integration: Displays a configurable status bar item showing your model quota usage.

    AG Usage Status Bar Preview

  • Auto-refresh: Usage data is automatically updated every 60 seconds by default, but can be configured. By default, it also pauses background refreshes when the IDE window is unfocused.

  • Detailed tooltip: Hover over the status bar item to see a detailed breakdown and visual progress bars for model categories (as they are calculated by Antigravity):

    • Gemini - Gemini Pro and Gemini Flash models
    • Other - Claude and GPT models
    • Argon - Gemini 4 Argon weekly limit (Pro)

    AG Usage Tooltip Preview

  • Quota reset timer: Each model category displays the time remaining until quota resets. Time is displayed only when the Antigravity quota reset timer is triggered (first use of the AI model after a 100% usage).

  • Cross-platform: Fully compatible with Windows, macOS, and Linux.

  • Works in VS Code too: Detects both the Antigravity IDE's language_server process and the agy hub started by the Google Antigravity extension for VS Code.

📖 Usage

  1. Install the extension.
  2. Make sure the Antigravity IDE or the Antigravity extension for VS Code (google.google-antigravity) is running and logged in.
  3. Look for the 🚀 icon in the right part of the bottom status bar.
  4. Hover over the icon to view detailed usage per model category.
  5. Click the icon to refresh data manually.

📝 Configuration

  • ag-usage.refreshInterval: Set the interval (in seconds) between automatic refreshes. Set to 0 to disable auto-refresh. Default is 60 seconds.

  • ag-usage.pauseWhenUnfocused: Pause automatic background refresh when the VS Code window is not focused. Default is true.

  • ag-usage.statusBarDisplay: List of items to display in the status bar, in order. Default is ["gemini", "other", "argon"]. Available items:

    • gemini - Gemini usage
    • other - Other usage
    • argon - Gemini 4 Argon weekly limit (Pro)
    • average - Average usage across all groups
  • ag-usage.statusBarLimitDisplay: Control how to display the quota limits in the status bar. Options:

    • 5h - Shows only the 5-hour quota (omits groups without 5-hour limits, e.g., Gemini 77%)
    • weekly - Shows only the weekly quota (e.g., Gemini 99%)
    • both (default) - Shows both 5-hour and weekly quotas (e.g., Gemini 21% (99%), Argon (99%))
  • ag-usage.statusBarAlignment: Control the alignment of the status bar item. Options: Left, Right (default).

  • ag-usage.statusBarPriority: Control the priority of the status bar item. Higher values move the item further to the left (for Right alignment). Default is 100.

  • ag-usage.statusBarCountdown: Show time remaining until next reset in the status bar when quota reaches 0%. Default is true.

  • ag-usage.statusBarWeeklyReset: Show time remaining until weekly reset next to the weekly quota percentage in the status bar (e.g., (67% 1d 2h)). Default is false.

  • ag-usage.notifyOnFullQuota: Show a notification when a model category reaches 100% usage. Default is false.

  • ag-usage.lowQuotaNotificationThreshold: Percentage threshold to show a warning when quota drops below this value. Default is 0 (disabled). Set to a value like 10 to enable.

  • ag-usage.resetTimeDisplay: How to display the quota reset time. Options: relative, absolute, both (default).

  • ag-usage.absoluteTimeFormat: Time format for absolute reset time display. Options: 24h (default), 12h.

  • ag-usage.dateFormatLocale: Locale for date formatting (e.g., 'en-US', 'ro-RO', 'default'). Default is 'default'.

  • ag-usage.enableHistoryTracking: Enable tracking of quota usage history over time. Default is true.

  • ag-usage.enablePublicStatus: Fetch public Google Antigravity service health from StatusGator. When disabled, the dashboard only checks the local usage API. Default is true.

  • ag-usage.panelSections: Dashboard section order (plan, health, quotas, resets, models, activity). Prefix a section with ! to hide it (for example !health). Reorder or hide sections from the dashboard title bar, or edit this list in settings. Default is all six in that order.

  • ag-usage.maxHistoryItems: Maximum number of history items to persist per group. Default is 50.

⚙️ Commands

  • ag-usage.refresh: Manually triggers a scan for the Antigravity process and updates usage statistics.

  • ag-usage.openSettings: Opens the AG Usage configuration page.

  • ag-usage.openPanel: Opens the AG Usage detailed webview panel that shows current quotas and history of quota changes.

  • ag-usage.exportHistory: Export the metadata history log to a JSON file (available in the dashboard title bar).

🔒 Security & Privacy

  • Local quota communication: The extension reads quota data from your local Antigravity process over localhost.
  • Public status check: The dashboard fetches public Google Antigravity service health from StatusGator. Disable it with the ag-usage.enablePublicStatus setting.
  • Limited local persistence: It stores quota history metadata locally in VS Code global state (category, quota delta, timestamps, reset time) to power the history panel.

📝 Notes

  • Data from server may have a 3-5 minute margin of error. This can result in a "Soon" status or temporary delays in quota synchronization.

  • At the moment, it is not possible to retrieve the actual token quota.

  • Starting with Antigravity 1.18.3, native quota tracking is available under the Antigravity User Settings > Models page.

💡 Inspiration

  • This extension was inspired by the AntigravityQuota extension, which provides similar functionality.
  • Also, inspired by the progressbar idea for creating progress bars in markdown tooltips because VS Code extension API does not support pop-up menus like the GitHub Copilot one.

💖 Support the Development

If you find this extension useful, consider buying me a coffee!

Donate with PayPal


🙏 Thank you for using AG Usage!

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft