Quick Start (No Login Required) 🚀

If you have Antigravity running in your IDE (VSCode, JetBrains, etc.), you can check your quota immediately without logging in.

# Install globally
npm install -g antigravity-usage

# Check quota immediately (uses your IDE's connection)
antigravity-usage

That's it! The tool automatically connects to your local Antigravity server to fetch the exact same data your IDE sees.

Power User Guide ⚡️

Want to check quota for multiple accounts or when your IDE is closed?

1. Login with Google

antigravity-usage login

1a. Manual Login (Headless/SSH)

If you are on a headless server or cannot open a browser locally:

antigravity-usage login --manual

Follow the on-screen instructions to paste the authentication URL into your local browser and copy the result back.

2. Add more accounts

antigravity-usage accounts add

3. Check everything at once

antigravity-usage quota --all

How It Works 🛠️

Antigravity Usage employs a smart "Dual-Fetch" strategy to ensure you always get data:

1. Local Mode (Priority): First, it tries to connect to the Antigravity Language Server running inside your IDE.
   • Pros: Fast, works offline, no extra login required.
   • Cons: IDE must be open.
2. Cloud Mode (Fallback): If Local Mode fails (or if managing multiple accounts), it uses the Google Cloud Code API.
   • Pros: Works anywhere, supports multiple accounts.
   • Cons: Requires one-time login.

By default, antigravity-usage runs in Auto Mode, seamlessly switching between these methods.

Features

🤖 Auto Wakeup (macOS & Linux)

Never waste quota again. Automatically wake up your AI models to maximize your daily limits.

• Fully Automatic: Runs in the background via native system scheduler - no need to keep terminal or Antigravity open
• Native Cron Integration: Schedule-based triggers (every N hours, daily, or custom cron)
• Smart Quota-Reset Detection: Zero-waste mode that detects when quota resets
• Multi-Account Support: Trigger all your accounts simultaneously
• Built-in Safety: Cooldown protection, retry logic, detailed history tracking
• Platform Support: Currently available on macOS and Linux (Windows support coming soon)

See the Wakeup Command section for full details.

🔐 Multi-Account Management

Manage multiple Google accounts and compare quota across Personal, Work, and other accounts.

• Check All Accounts: Use --all flag to fetch and compare quota across all logged-in accounts simultaneously
• Side-by-Side Comparison: View quota usage and reset times for all accounts in a single table
• Easy Switching: Switch between accounts to use different credentials for API calls
• Privacy Focused: All tokens stored locally on your machine, never sent to third-party servers

🔌 Offline Capabilities

Designed for plane rides and spotty wifi.

• Direct IDE Access: Reads directly from the local server loopback.
• Smart Fallbacks: If the internet cuts out, it defaults to the last known state from your local IDE.

⚡️ Smart Caching

To keep the CLI snappy and avoid hitting API rate limits:

• Quota data is cached for 5 minutes.
• Use the --refresh flag to force a new fetch:

  antigravity-usage quota --refresh

🎯 Focused Model View

By default, antigravity-usage hides "autocomplete" models (like gemini-2.5-flash-002) to reduce clutter, as these typically share quota with their main counterparts or are less relevant for tracking.

To see ALL available models, including autocomplete ones:

antigravity-usage quota --all-models

Command Reference

antigravity-usage (Default)

Alias for quota. Fetches and displays usage data.

antigravity-usage                   # Auto-detect (Local -> Cloud)
antigravity-usage --all             # Fetch ALL accounts
antigravity-usage --method local    # Force local IDE connection
antigravity-usage --method google   # Force google IDE connection
antigravity-usage --all-models      # Show ALL models (including autocomplete)
antigravity-usage --json            # Output JSON for scripts
antigravity-usage --version         # Show version number

antigravity-usage --version

Display the current version of the CLI tool.

antigravity-usage --version  # or -V

antigravity-usage accounts

Manage your roster of Google accounts.

antigravity-usage accounts list            # Show all accounts & status
antigravity-usage accounts add             # Login a new account
antigravity-usage accounts switch <email>  # Set active account
antigravity-usage accounts remove <email>  # Logout & delete data

antigravity-usage doctor

Troubleshoot issues with your setup. Checks env vars, auth status, and local server connectivity.

antigravity-usage status

Quickly check if your auth tokens are valid or expired.

antigravity-usage wakeup 🚀

Never waste quota again. Automatically wake up your AI models at strategic times to maximize your daily limits.

Platform Support: Currently available on macOS and Linux. Windows support (via Task Scheduler) is coming soon.

antigravity-usage wakeup config     # Interactive setup (takes 30 seconds)
antigravity-usage wakeup install    # Install to native system cron
antigravity-usage wakeup status     # Check configuration & next run
antigravity-usage wakeup test       # Test trigger manually (interactive)
antigravity-usage wakeup history    # View trigger history

Quick Test with Flags:

# Test with specific email and model
antigravity-usage wakeup test -e [email protected] -m claude-sonnet-4-5

# Full command with custom prompt
antigravity-usage wakeup test --email [email protected] --model gemini-3-flash --prompt "hello"

# Mix flags (missing ones will be prompted)
antigravity-usage wakeup test -e [email protected]

Available Options:

• -e, --email <email> - Account email to use for testing
• -m, --model <model> - Model ID to test (e.g., claude-sonnet-4-5, gemini-3-flash)
• -p, --prompt <prompt> - Test prompt to send (default: "hi")

Why This Matters: Your Antigravity quota resets every ~5 hours, but if you don't use it, you lose it. The wakeup feature ensures you automatically trigger both Claude and Gemini models to keep your quota flowing.

🎯 Intelligent Model Selection

Zero configuration needed. Automatically wakes up:

• claude-sonnet-4-5 → Triggers the entire Claude family
• gemini-3-flash → Triggers Gemini flash quota group
• gemini-3-pro-low → Triggers Gemini pro quota group

All three models combined ensure comprehensive coverage and optimal quota utilization across all available AI models and quota groups.

⚡️ Two Powerful Trigger Modes

1. Schedule-Based (Native Cron Integration) Runs locally on your machine with zero dependencies:

• Interval Mode: Every N hours (e.g., every 6 hours)
• Daily Mode: At specific times (e.g., 9 AM, 5 PM)
• Custom Mode: Advanced cron expressions for power users
• Portable Design: Auto-detects Node.js path for seamless operation across different machines

antigravity-usage wakeup install
# ✅ Installs to your system's native crontab (macOS/Linux)
# ✅ Runs even when terminal/antigravity is closed
# ✅ Persists across reboots
# ✅ Works on any machine with Node.js installed

2. Smart Quota-Reset Detection (Zero-Waste Mode) The most intelligent trigger mode. Automatically detects when:

• Quota is at 100% (unused)
• Reset time is ~5 hours away (just reset)
• No cooldown conflicts

When triggered, it wakes up ALL your accounts simultaneously, ensuring none of your quota goes to waste.

🛡️ Built-in Safety Features

• Cooldown Protection: Prevents duplicate triggers (1-hour default)
• Multi-Account Support: Trigger for specific accounts or all at once
• Detailed History: Track every trigger with timestamps and results
• Graceful Failures: Automatic retry logic with exponential backoff
• Token Efficiency: Minimal output tokens (just 1 token per request)

📊 Real-Time Monitoring

antigravity-usage wakeup status

Shows:

• ✅ Enabled/disabled status
• 📅 Next scheduled run time
• 🎯 Selected models and accounts
• 📝 Last trigger result
• ⚙️ Cron installation status

Configuration

Data is stored in your system's standard config location:

• macOS: ~/Library/Application Support/antigravity-usage/
• Linux: ~/.config/antigravity-usage/
• Windows: %APPDATA%/antigravity-usage/

Development

npm run dev -- quota --all
npm test

License

MIT