Antigravity Limit — VS Code / Antigravity IDE Extension

A lightweight, high-performance extension designed to monitor, log, and display AI model limits (quotas), weekly buckets, and prompt credits directly from the local Antigravity Language Server in real-time.

📸 Screenshots & Highlights

Glassmorphic Interactive Dashboard	Activity Bar Sidebar TreeView

Real-Time Status Bar & Color-Coded Health	QuickPick Shortcuts & Model Switching

⚡ Features

1. Activity Bar / Sidebar TreeView: A dedicated sidebar panel in VS Code displaying real-time AI Credits, Gemini model quotas, Claude/GPT model quotas, 5-hour/weekly limits, and language server connection status with one-click model switching.
2. Status Bar Widget: Located at the bottom-right of your window, it displays current quota health with green/yellow/red color-coding based on consumption and overall remaining capacity.
3. Interactive Glassmorphic Dashboard: A high-tech panel rendering radial progress rings, model details, token usage bars, weekly/5-hour quota limits, and usage timeline logs.
4. Real Usage Analytics & CSV/JSON Export: Automatically aggregates daily request counts and token consumption per model for the last 30 days. Export your historical usage to CSV or JSON with a single click.
5. Configurable Smart Fallback Priority Chain: When the active model group's quota falls below a configurable critical threshold (default: <= 10%), automatically or with confirmation prompts switches to the next healthy model based on your custom priority chain.
6. Quota Reset Notifications: Dynamically detects when a previously depleted or critical model group gets its quota reset back to healthy (> 50%) and displays a VS Code information notification.
7. Responsive Grid & Side Panel Support: The layout collapses dynamically to a single-column layout at widths below 1150px and supports container widths down to 280px, preventing horizontal overflow and aligning perfectly in side panels and editors.
8. Premium Dark/Light Mode: Toggle between a sleek dark theme and a clean light theme using the simple icon button at the top-right of the dashboard. Your theme preference is persisted across sessions in localStorage.
9. Interactive Status Bar Customization: Change the display format of the status bar widget directly from the dashboard sidebar. Supported modes include:
   • Model Quota % (models): Displays model percentages (e.g., 🟩 Gemini 80% | 🟥 Claude 0%).
   • AI Credits Only (credits): Displays remaining credits only (e.g., ⚡ 1,250 / 2,000).
   • Both Quota % & Credits (both): Displays percentages and credits (e.g., 🟩 80% | 🟥 0% | ⚡ 1,250).
   • Critical Group Only % (criticalOnly): Displays only the worst-performing group (e.g., 🟥 Claude 0%).
   • Remaining Count (remainingOnly): Displays raw remaining count values instead of percentages (e.g., Gemini 60/100 | Claude 60/100).
   • Critical Group Count (criticalOnlyRemaining): Displays the remaining count of the critical model group only (e.g., Gemini 60/100).
   • Active Groups Only % (activeOnly): Shows percentages of active groups and hides finished/depleted ones.
10. QuickPick Menu: Click the status bar widget to open a dropdown menu showing detailed quota metrics for each model, AI credits, and shortcut actions (Refresh, Language Toggle, and more).
11. Modernized Zero-Resource Idle State: Optimized PowerShell CIM and Unix process queries with caching, strict command timeouts, and adaptive polling intervals (3s when focused, 15s in background) to ensure minimal CPU/RAM footprint.
12. Watchdog Warning Banner: Displays connection status and latency dynamically with a Restart Language Server recovery action in the dashboard if the server goes offline.

⚙️ Settings Configuration

You can configure custom options and fallback behavior in your user settings.json:

{
  "antigravity-limit.language": "tr", // "tr" for Turkish or "en" for English
  "antigravity-limit.warnThreshold": 80, // Trigger warning at 80% consumption
  "antigravity-limit.statusBarDisplayMode": "models", // Status bar display format
  "antigravity-limit.smartFallbackMode": "auto", // "auto", "confirm", or "disabled"
  "antigravity-limit.fallbackCriticalThreshold": 10, // Critical percentage threshold
  "antigravity-limit.fallbackModelPriority": [
    "Claude Sonnet 4.6 (Thinking)",
    "Claude Opus 4.6 (Thinking)",
    "Gemini 3.1 Pro (High)",
    "Gemini 3.5 Flash (High)",
    "GPT-OSS 120B (Medium)"
  ],
  "antigravity-limit.refreshIntervalFocused": 3000, // Polling interval (ms) when focused
  "antigravity-limit.refreshIntervalUnfocused": 15000, // Polling interval (ms) when in background
  "antigravity-limit.historyRetentionDays": 30 // Retention days for analytics history
}

📦 Packaging & Installation

To compile this extension into a .vsix package:

1. Build the Extension Package

Run the following command in the project root directory:

npx @vscode/vsce package

This compiles the codebase and outputs an installer package file named: antigravity-limit-1.0.0.vsix

2. Install the Extension

You can install the compiled .vsix file in your editor of choice:

• Via GUI:
  1. Open VS Code/Cursor.
  2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac) to open the Command Palette.
  3. Type Install from VSIX... and select it.
  4. Browse and select the generated antigravity-limit-1.0.0.vsix file.
• Via CLI:

  code --install-extension antigravity-limit-1.0.0.vsix
  

🚀 Development Mode

1. Open the project root folder in VS Code.
2. Go to the Run & Debug view in the sidebar (Ctrl+Shift+D).
3. Select Run Extension and press F5.
4. This will open a new window (the Extension Development Host) with your local modifications loaded.