Troubleshooting & FAQ

Troubleshooting & FAQ

Frequently asked questions and troubleshooting steps for Antigravity Usage Intelligence.

---

❓ 1. "Python was not found" or statistics aren't updating

Symptom: Status bar shows $(sync~spin) or stats remain at 0 tokens.

Cause: Python is required to execute collector.py. If Python is installed in a non-standard location or Windows App Execution Aliases are redirecting python.exe to the Microsoft Store, the extension cannot locate it.

Solution:

1. Open IDE Settings (Ctrl+, or Cmd+,).
2. Search for: antigravity-stats.pythonPath.
3. Provide the explicit path to your Python 3 executable:
   • Windows: C:\Users\<YourUser>\AppData\Local\Programs\Python\Python311\python.exe (or C:\Python311\python.exe)
   • macOS / Linux: /usr/local/bin/python3 or /opt/homebrew/bin/python3
4. Press Ctrl+Shift+P → Antigravity Stats: Refresh Stats.

---

❓ 2. How do I force a complete cache rebuild?

If you suspect corrupted cache data or have deleted old sessions:

1. Press Ctrl+Shift+P.
2. Type and select: Antigravity Stats: Rebuild Full History Cache.
3. The extension wipes ~/.gemini/antigravity/antigravity_stats_cache.json and performs a clean full-history index.

---

❓ 3. Why does the Model Quota card say "Local Estimate" instead of live server pools?

Explanation: The extension attempts to query the Antigravity Language Server running locally on your machine via loopback HTTPS.

• If the IDE language server is starting up or has not initialized its CSRF handshake yet, the extension gracefully falls back to calculating your active usage using a rolling 5-hour local sliding window.
• Once the language server is fully initialized, the quota card automatically transitions to displaying live server pool metrics and the live countdown timer.

---

❓ 4. Will this extension slow down my IDE or cause database locks?

No.

• collector.py opens all SQLite databases using URI read-only mode (?mode=ro&immutable=1) with PRAGMA query_only = ON.
• This guarantees that Antigravity's active writing processes are never blocked or delayed.
• All scans execute in a detached background child process and take less than 80ms on cached runs.

---

❓ 5. Does this extension send my code or tokens to the internet?

No. 100% Local & Private.

• The extension contains zero outbound telemetry beacons.
• The only network activity is local IPC communication to 127.0.0.1 (loopback) to communicate with Antigravity's local language server.
• Prompts, diffs, source files, and credentials are never stored, parsed, or transmitted.