Skip to main content

Google Antigravity

Google Antigravity is an agentic development platform that evolves the IDE into an agent-first era. Released November 18, 2025, it's powered by Gemini 3 and treats AI agents as first-class citizens capable of autonomously planning, executing, and verifying complex tasks across editor, terminal, and browser.

Core Architecture​

Antigravity has two primary interfaces:

Agent Manager (Mission Control)​

The central hub for orchestrating agents. Features:

  • Inbox: Track all conversations and agent tasks
  • Workspaces: Manage multiple project workspaces
  • Playground: Scratch area for quick agent interactions
  • Start Conversation: Begin new agent tasks

Editor View​

VS Code-based interface with AI augmentation:

  • Tab completions and inline commands
  • Agent side panel for direct interaction
  • File explorer and syntax highlighting
  • Toggle between views: Cmd + E (Mac) / Ctrl + E (Windows)

Agent Modes​

Planning Mode (Default)​

Agent creates task plans before executing. Use for:

  • Complex, multi-step tasks
  • Deep research
  • Collaborative work requiring review

Fast Mode​

Agent executes directly without planning. Use for:

  • Simple tasks (renaming variables, quick bash commands)
  • Speed-critical operations
  • Localized changes

Rules and Workflows​

Rules (System Instructions)​

Passive, persistent guidelines the agent always follows. Stored in:

Global Rules: ~/.gemini/GEMINI.md

  • Apply to all projects
  • Define personal coding philosophy
  • Example: "Always use TypeScript", "Add docstrings to all functions"

Workspace Rules: <workspace>/.agent/rules/

  • Project-specific rules
  • Override or extend global rules

Workflows (Saved Prompts)​

Triggered on-demand with / command. Stored in:

Global Workflows: ~/.gemini/antigravity/global_workflows/ Workspace Workflows: <workspace>/.agent/workflows/

Workflow file format (requires YAML frontmatter):

---
description: Brief description of what this workflow does
---

1. Step one instructions
2. Step two instructions
   ```code
   // turbo - auto-execute this command
  1. Step three instructions

Use `// turbo` comments to auto-execute terminal commands within workflows.

## Security Configuration

### Terminal Execution Policies

Access via: Settings → Advanced Settings → Agent → Terminal

| Policy | Behavior | Use Case |
|--------|----------|----------|
| **Off** | All commands require approval | Production, sensitive projects |
| **Auto** | Agent decides when to ask | Development environments |
| **Turbo** | Auto-execute all commands | Maximum speed, trusted environments |

### Allow List (for Off policy)
Whitelist specific commands the agent can run automatically.

### Deny List (for Turbo/Auto policy)
Blacklist dangerous commands requiring approval.

## Best Practices

### Development Workflow
1. Write focused, goal-based prompts (not step-by-step instructions)
2. Review Task List and Implementation Plan before proceeding
3. Use Planning mode for complex tasks
4. Leave comments on artifacts to guide refinement
5. Spawn multiple agents for parallel work

### Security Best Practices
1. Use "Off" terminal policy for production branches
2. Audit browser allowlist, remove webhook services
3. Enable human-in-the-loop for MCP server tools
4. Use dedicated Google account for automation
5. Never store credentials in agent-accessible files

### Project Structure

project/ ├── .agent/ │ ├── rules/ # Workspace rules │ └── workflows/ # Workspace workflows ├── artifacts/ # Agent outputs (plans, logs) └── src/ # Source code


## File System Locations

| Purpose | Path |
|---------|------|
| Global rules | `~/.gemini/GEMINI.md` |
| Global workflows | `~/.gemini/antigravity/global_workflows/` |
| MCP config | `~/.gemini/antigravity/mcp_config.json` |
| Browser allowlist | `~/.gemini/antigravity/browserAllowlist.txt` |
| Workspace rules | `<workspace>/.agent/rules/` |
| Workspace workflows | `<workspace>/.agent/workflows/` |

## System Requirements

- **macOS**: 12+ (Monterey or later), Apple Silicon optimal
- **Windows**: 64-bit Windows 10+
- **Linux**: glibc >= 2.28 (Ubuntu 20+, Debian 10+, Fedora 36+)
- **RAM**: 4GB minimum, 8GB recommended
- **Disk**: 2GB+ free space
- **Chrome**: Required for browser automation