Google Antigravity Troubleshooting: Complete Guide to Fixing Every Issue

Running into problems with Google Antigravity? This comprehensive troubleshooting guide covers every common issue, from installation problems to AI response errors. Bookmark this page for quick solutions.

Quick Diagnostic Checklist

Before diving deep, run through this quick checklist:

□ Is Antigravity updated to the latest version?
□ Is your internet connection stable?
□ Are your API credentials valid?
□ Is there sufficient disk space?
□ Are system requirements met?

Need fresh install? Follow our complete installation guide.

---

Installation Issues

Problem: Installation Fails on macOS

Symptoms:

• "Package is damaged" error
• Installation hangs at verification
• "Cannot be opened" security warning

Solutions:

1. Security Settings Fix:

# Allow app from identified developers
sudo spctl --master-disable

# After installation, re-enable
sudo spctl --master-enable

2. Remove Quarantine Attribute:

xattr -dr com.apple.quarantine /Applications/Antigravity.app

3. Complete Reinstall:

# Remove all Antigravity data
rm -rf /Applications/Antigravity.app
rm -rf ~/Library/Application\ Support/Antigravity
rm -rf ~/.config/antigravity

# Download fresh installer

Problem: Installation Fails on Windows

Symptoms:

• "Windows protected your PC" message
• Installer crashes
• Missing DLL errors

Solutions:

1. Run as Administrator:

   • Right-click installer
   • Select "Run as administrator"

2. Disable SmartScreen Temporarily:

# Run in PowerShell as Admin
Set-MpPreference -EnableSmartScreen $false
# Reinstall, then re-enable
Set-MpPreference -EnableSmartScreen $true

3. Install Visual C++ Redistributable:
   • Download from Microsoft
   • Install both x64 and x86 versions

Problem: Installation Fails on Linux

Symptoms:

• Dependency errors
• Permission denied
• AppImage won't launch

Solutions:

1. Install Dependencies (Ubuntu/Debian):

sudo apt update
sudo apt install libfuse2 libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils

2. Make AppImage Executable:

chmod +x Antigravity-*.AppImage
./Antigravity-*.AppImage

---

Startup Issues

Problem: Antigravity Won't Start

Symptoms:

• App icon bounces then disappears
• Black screen on launch
• Crash on startup

Solutions:

1. Clear Cache:

# macOS/Linux
rm -rf ~/.config/antigravity/Cache
rm -rf ~/.config/antigravity/GPUCache

# Windows
rmdir /s /q %APPDATA%\antigravity\Cache

2. Reset Configuration:

# Backup first
mv ~/.config/antigravity ~/.config/antigravity.backup

# Restart Antigravity - creates fresh config

3. Check GPU Drivers:

# Disable GPU acceleration
antigravity --disable-gpu

4. Check Logs for Errors:

# macOS/Linux
cat ~/.config/antigravity/logs/main.log

# Windows
type %APPDATA%\antigravity\logs\main.log

Problem: Slow Startup

Symptoms:

• Takes 30+ seconds to start
• "Loading extensions" hangs
• Indexing never completes

Solutions:

1. Exclude Large Directories from Indexing:

{
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/.git": true,
    "**/build": true
  }
}

2. Increase Memory Limit:

antigravity --max-memory=8192

---

AI and Response Issues

Problem: AI Not Responding

Symptoms:

• "Thinking..." never completes
• Empty responses
• Timeout errors

Solutions:

1. Check API Status:

   • Visit status.google.com
   • Check Antigravity status page

2. Verify API Key:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.antigravity.google/v1/health

3. Reset Connection:

   • Press Cmd/Ctrl + Shift + P
   • Type "Reset AI Connection"
   • Press Enter

4. Check Firewall:

ping api.antigravity.google
ping gemini.googleapis.com

Problem: Poor AI Response Quality

Symptoms:

• Generic, unhelpful answers
• Ignores project context
• Repeats same suggestions

Solutions:

1. Rebuild Project Index:

   • Cmd/Ctrl + Shift + P
   • "Rebuild Project Index"
   • Wait for completion

2. Check Context Settings:

{
  "ai.contextWindow": "large",
  "ai.includeOpenFiles": true,
  "ai.includeGitHistory": true
}

3. Provide Better Prompts:

Learn effective prompting in our beginner's prompt guide:

Bad:  "Fix the bug"
Good: "Fix the authentication bug in src/auth/login.ts 
       where users can't login with valid credentials. 
       The error occurs at line 45."

4. Clear AI History:
   • Cmd/Ctrl + Shift + P
   • "Clear AI Conversation History"

---

MCP Server Issues

For comprehensive MCP setup, see our MCP servers guide.

Problem: MCP Server Not Connecting

Symptoms:

• "Server failed to start" error
• Tools not available
• Connection timeout

Solutions:

1. Verify Configuration:

# Check config syntax
cat ~/.config/antigravity/mcp.json | jq .

2. Test Server Manually:

# Run server directly
npx -y @anthropic-ai/mcp-github

# Check for errors in output

3. Check Credentials:

# Verify environment variables
echo $GITHUB_TOKEN
echo $POSTGRES_CONNECTION_STRING

4. View MCP Logs:

tail -f ~/.config/antigravity/logs/mcp-*.log

Browse working configurations in our MCP directory.

Problem: MCP Server Crashes

Symptoms:

• Server starts then dies
• Intermittent availability
• Memory errors

Solutions:

1. Increase Timeout:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-github"],
      "timeout": 60000
    }
  }
}

2. Update MCP Packages:

npm cache clean --force
npx -y @anthropic-ai/mcp-github@latest

---

Performance Issues

Problem: High CPU Usage

Symptoms:

• Fan constantly running
• System slowdown
• 100% CPU

Solutions:

1. Disable Real-time Features:

{
  "ai.realtimeSuggestions": false,
  "editor.quickSuggestions": false,
  "ai.backgroundAnalysis": false
}

2. Limit Indexing:

{
  "search.maxResults": 1000,
  "ai.maxFilesToAnalyze": 100
}

Problem: High Memory Usage

Symptoms:

• "Out of memory" errors
• System swap usage high
• Antigravity becomes unresponsive

Solutions:

1. Clear Memory:

   • Cmd/Ctrl + Shift + P
   • "Clear Memory Cache"

2. Reduce Open Files:

   • Close unused tabs
   • Limit to 10-15 open files

3. Adjust Memory Settings:

{
  "ai.maxContextSize": "medium",
  "editor.maxTokensPerFile": 50000
}

---

Agent Mode Issues

For complete Agent Mode guidance, see our Agent Mode mastery guide.

Problem: Agent Mode Stuck

Symptoms:

• "Executing..." never completes
• Same step repeating
• Progress bar frozen

Solutions:

1. Cancel and Retry:

   • Press Escape or click Cancel
   • Rephrase your request more specifically

2. Check Agent Logs:

cat ~/.config/antigravity/logs/agent.log | tail -100

3. Reduce Task Complexity:

Instead of: "Build a complete user authentication system"
Try: "Create the login form component"
Then: "Add the authentication API endpoint"

4. Enable Step Confirmation:

{
  "agent.confirmEachStep": true,
  "agent.maxStepsWithoutConfirmation": 3
}

Problem: Agent Making Wrong Changes

Symptoms:

• Modifying wrong files
• Breaking existing code
• Ignoring instructions

Solutions:

1. Use Git for Safety:

git stash  # Before agent work
# Run agent
git diff   # Review changes
git stash pop  # If needed

2. Be More Specific:

"Only modify src/components/Header.tsx.
Do not touch any other files.
Add a logout button next to the profile menu."

3. Enable Dry Run:

{
  "agent.dryRun": true
}

---

Network and Connectivity Issues

Problem: Behind Corporate Proxy

Symptoms:

• Connection refused
• SSL errors
• Timeout errors

Solutions:

1. Configure Proxy:

{
  "http.proxy": "http://proxy.company.com:8080",
  "http.proxyStrictSSL": false
}

2. Environment Variables:

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1

Problem: SSL Certificate Errors

Symptoms:

• "Certificate verify failed"
• "Self-signed certificate" error

Solutions:

1. Update Certificates:

# macOS
brew install ca-certificates

# Ubuntu
sudo apt update && sudo apt install ca-certificates

---

Getting Help

Collect Diagnostic Information

Before contacting support, gather:

# System info
antigravity --version
uname -a
node --version

# Logs
cat ~/.config/antigravity/logs/main.log
cat ~/.config/antigravity/logs/ai.log
cat ~/.config/antigravity/logs/mcp-*.log

Support Resources

• Community Forum - Ask questions, share solutions
• Best Practices - Prevent issues before they happen
• Use Cases - Learn from working examples
• MCP Directory - Working server configurations

---

Quick Reference Table

Issue	Quick Fix
Won't start	rm -rf ~/.config/antigravity/Cache
AI not responding	Check internet, reset connection
Slow performance	Disable unused extensions
MCP server error	Check credentials in mcp.json
Agent stuck	Cancel, reduce task complexity
High memory	Close tabs, clear cache

---

Last updated: December 2025

Related Articles:

• Complete Installation Guide
• MCP Servers Guide
• Agent Mode Mastery
• VS Windsurf Comparison
• Best Practices
• Community Support