Google Antigravity Troubleshooting
Fix common Google Antigravity issues with this comprehensive troubleshooting guide. Find solutions for performance problems, login issues, and agent errors.
🚫Antigravity Not Working / Not Starting
Symptoms
- •Application crashes on startup
- •Blank screen after launching
- •Error messages on launch
- •Application not responding
Solutions
1Check System Requirements
Ensure your system meets minimum requirements: 8GB RAM, 2GB disk space, 64-bit OS.
2Clear Cache and Restart
Delete the cache folder and restart: rm -rf ~/.gemini/cache (Mac/Linux) or delete %APPDATA%\Antigravity\cache (Windows)
3Reinstall Antigravity
Uninstall completely, delete ~/.gemini folder, then download and install the latest version.
4Check for Conflicting Software
Disable antivirus temporarily, check for conflicting VS Code instances, or VPN issues.
🔐Login & Authentication Problems
Symptoms
- •Cannot sign in with Google
- •Authentication loop
- •Session expired errors
- •Token refresh failures
Solutions
1Clear Authentication Data
Sign out completely, clear browser cookies for accounts.google.com, then sign in again.
2Check Google Account
Ensure your Google account is active and not restricted. Try logging in at accounts.google.com first.
3Disable VPN/Proxy
VPNs can interfere with Google authentication. Disable temporarily and try again.
4Reset Antigravity Auth
Delete ~/.gemini/auth folder and restart Antigravity to force a fresh login.
🐢Slow Performance & Lag
Symptoms
- •Slow typing response
- •Agent takes too long to respond
- •UI freezes or stutters
- •High CPU/memory usage
Solutions
1Reduce Extensions
Disable unused extensions. Go to Extensions (Cmd/Ctrl+Shift+X) and disable non-essential ones.
2Use Fast Mode
Switch from Plan mode to Fast mode for simple tasks. Plan mode is slower but more thorough.
3Close Unused Tabs
Close files you are not actively editing. Each open file consumes memory.
4Increase Memory Limit
In Settings, search for "memory" and increase the max memory limit if available.
5Exclude Large Folders
Add node_modules, .git, and build folders to the exclusion list in settings.
🤖AI Agent Not Responding
Symptoms
- •Agent panel shows loading forever
- •"Unable to connect" errors
- •Responses are cut off
- •Agent ignores instructions
Solutions
1Check Internet Connection
AI features require internet. Test your connection and try again.
2Wait and Retry
Rate limits may apply. Wait 30 seconds and try a simpler request.
3Clear Agent Context
Start a new chat session to clear accumulated context that might be confusing the agent.
4Check Quota
Free tier has usage limits. Check your quota in Settings > Account.
5Simplify Your Request
Break complex requests into smaller, specific tasks for better results.
🔌MCP Server Connection Issues
Symptoms
- •MCP server not connecting
- •Tools not appearing in agent
- •Server crashes or timeouts
- •Authentication errors with MCP
Solutions
1Verify Configuration
Check your .antigravity/mcp.json or GEMINI.md for correct server configuration.
2Check Server Status
Ensure the MCP server is running. Check terminal for error messages.
3Update Environment Variables
Verify all required API keys and credentials are set in your environment.
4Restart Antigravity
MCP servers are loaded on startup. Restart Antigravity to reload configurations.
💻Poor Code Generation Quality
Symptoms
- •Agent generates incorrect code
- •Code does not follow project conventions
- •Missing imports or dependencies
- •Outdated patterns or libraries
Solutions
1Add Project Rules
Create a .antigravity file with your coding standards, framework preferences, and conventions.
2Provide Context
Include relevant code snippets in your request. The more context, the better.
3Use Specific Instructions
Instead of "build a form", say "build a React form with Zod validation using our Button component".
4Review and Iterate
Ask the agent to fix specific issues rather than regenerating from scratch.
🛡️ Prevention Tips
Avoid common issues by following these best practices:
Configure Project Rules
Set up proper project configuration to ensure AI generates code that follows your conventions.
→ Setup .antigravity rulesUse GEMINI.md
Add a GEMINI.md file to provide context about your project structure and preferences.
→ GEMINI.md guideFollow Best Practices
Learn the recommended patterns for prompting and working with the AI agent.
→ Read best practicesUnderstand Agent Mode
Learn when to use Agent Mode vs normal autocomplete for better results.
→ Agent Mode guide🔧 Advanced Troubleshooting
Diagnostic Commands
Use these commands to diagnose issues:
# Check Antigravity version
antigravity --version
# View logs
antigravity --verbose
# Reset to default settings
antigravity --reset-config
# Check MCP server status
antigravity mcp list
Configuration Files Location
Key configuration files that affect Antigravity behavior:
~/.gemini/- Global settings and cache.antigravity- Project-specific AI rules (learn more)GEMINI.md- Project context file (setup guide).antigravity/mcp.json- MCP server configs (MCP servers)
Performance Optimization
For large projects, optimize performance by configuring exclusions:
# In your .antigravity file:
exclude_patterns:
- node_modules/**
- .git/**
- dist/**
- build/**
- coverage/**
- *.log
See our .antigravity rules guide for complete configuration options.
⚡ Optimize Your Workflow
Many issues stem from inefficient workflows. Learn how to work more effectively:
Still Need Help?
If you're still experiencing issues after trying these solutions:
- →Check the GitHub Issues for known bugs
- →Join the Antigravity Discord community
- →Submit feedback through the Help menu in Antigravity
- →Browse our blog for tips and tutorials