Documentation

Everything you need to know about Google Antigravity

Core Concepts

Agent-First Architecture

Antigravity is built around the concept of autonomous agents that can independently handle complex development tasks. Unlike traditional IDEs where AI assists you, Antigravity allows you to delegate entire workflows to agents.

Key Benefits: Parallel task execution, automated testing, continuous learning

Artifacts & Verification

Every agent action generates artifacts - tangible deliverables like task lists, implementation plans, screenshots, and test results. This builds trust and provides transparency into what agents are doing.

Artifact Types: Task lists, screenshots, browser recordings, test reports, code diffs

Multi-Surface Integration

Agents operate across three surfaces: the editor (code), the terminal (commands), and the browser (UI testing). This comprehensive access enables end-to-end feature development.

Capabilities: File editing, command execution, web navigation, DOM inspection

Learning & Knowledge Base

Agents maintain a knowledge base of useful patterns, solutions, and context from past tasks. This allows them to improve over time and apply learned patterns to new situations.

What's Saved: Code snippets, architecture patterns, debugging solutions, API patterns

Key Features

๐ŸŽฏ Editor View

  • โ€ข AI-powered tab completions
  • โ€ข Inline refactoring commands
  • โ€ข Multi-file contextual editing
  • โ€ข Smart code suggestions

๐ŸŽ›๏ธ Agent Manager

  • โ€ข Deploy multiple agents in parallel
  • โ€ข Monitor real-time progress
  • โ€ข Configure autonomy levels
  • โ€ข Review and approve actions

๐Ÿงช Testing & Validation

  • โ€ข Automated UI testing
  • โ€ข Unit test generation
  • โ€ข Visual regression detection
  • โ€ข Browser-based verification

๐Ÿ”„ Multi-Model Support

  • โ€ข Gemini 3 Pro (default)
  • โ€ข Claude Sonnet 4.5
  • โ€ข OpenAI GPT models
  • โ€ข Switch models per task

Common Workflows

Feature Development Workflow

  1. 1.
    Plan: Describe the feature to an agent. It creates a task list and implementation plan.
  2. 2.
    Implement: Agent writes code across multiple files, installs dependencies, and sets up configuration.
  3. 3.
    Test: Agent launches the application in the browser and verifies functionality.
  4. 4.
    Review: Check artifacts (screenshots, test results) and provide feedback if needed.

Bug Fixing Workflow

  1. 1.
    Reproduce: Describe the bug. Agent reproduces it in the browser and captures evidence.
  2. 2.
    Investigate: Agent examines related code, logs, and stack traces to identify root cause.
  3. 3.
    Fix: Agent implements the fix and creates regression tests.
  4. 4.
    Verify: Agent runs tests and confirms the bug is resolved.

Best Practices

โœ… DO

  • โœ“ Provide clear, specific task descriptions
  • โœ“ Break complex features into smaller tasks
  • โœ“ Review artifacts regularly
  • โœ“ Start with lower autonomy, increase as you build trust
  • โœ“ Save useful patterns to agent knowledge base
  • โœ“ Provide feedback to improve agent performance

โŒ DON'T

  • โœ— Give vague instructions like "make it better"
  • โœ— Skip artifact review for critical changes
  • โœ— Deploy agents with full autonomy on unfamiliar codebases
  • โœ— Ignore agent questions or requests for clarification
  • โœ— Forget to version control before major agent tasks
  • โœ— Mix unrelated features in a single agent task

Additional Resources

๐Ÿ’ก Need Help?

This is a community resource for Google Antigravity. For official support and latest updates, visit the Google Developers Blog.