antigravity-balance

name	antigravity-balance
description	Check Google Antigravity AI model quota/token balance. Use when a user asks about their Antigravity usage, remaining tokens, model limits, quota status, or rate limits. Works by detecting the local Antigravity language server process and querying its API.

Antigravity Balance

Check your Antigravity AI model quota and token balance.

Quick Start

# Check quota (auto-detects local Antigravity process)
node scripts/agquota.js

# JSON output for parsing
node scripts/agquota.js --json

# Verbose output (debugging)
node scripts/agquota.js -v

How It Works

1. Process Detection: Finds the running language_server_macos_arm (or platform equivalent) process
2. Extracts Connection Info: Parses --extension_server_port and --csrf_token from process args
3. Port Discovery: Scans nearby ports to find the HTTPS API endpoint (typically extensionPort + 1)
4. Queries Local API: Hits https://127.0.0.1:{port}/exa.language_server_pb.LanguageServerService/GetUserStatus
5. Displays Quota: Shows remaining percentage, reset time, and model info

Output Format

Default output shows:

• User name, email, and tier
• Model name and remaining quota percentage
• Visual progress bar (color-coded: green >50%, yellow >20%, red ≤20%)
• Reset countdown (e.g., "4h 32m")

JSON output (--json) returns structured data:

{
  "user": { "name": "...", "email": "...", "tier": "..." },
  "models": [
    { "label": "Claude Sonnet 4.5", "remainingPercent": 80, "resetTime": "..." }
  ],
  "timestamp": "2026-01-28T01:00:00.000Z"
}

Requirements

• Node.js (uses built-in https module)
• Antigravity (or Windsurf) must be running

Troubleshooting

If the script fails:

1. Ensure Antigravity/Windsurf is running
2. Check if the language server process exists: ps aux | grep language_server
3. The process must have --app_data_dir antigravity in its args (distinguishes from other Codeium forks)

Platform-Specific Process Names

Platform	Process Name
macOS (ARM)	language_server_macos_arm
macOS (Intel)	language_server_macos
Linux	language_server_linux
Windows	language_server_windows_x64.exe