Google Antigravity vs Augment Code

Google Antigravity vs Augment CodeComparisonUpdated 2026-03-18

SUMMARY

Google Antigravity (IDE) uses markdown configuration while Augment Code (IDE) uses markdown. They differ on 1 of 11 compared features. Both tools provide AI-assisted development but take different approaches to project configuration.

FEATURE COMPARISON

Feature	Google Antigravity	Augment Code	Notes
Config format	markdown	markdown
Hierarchy support	✓	✓	Whether config files can be placed at multiple directory levels
Global config	✗	✓	User-wide configuration outside any project
Project config	✓	✓
Subdirectory scoping	✓	✓	Config files in subdirectories that apply only to that subtree
File inclusion / imports	✗	✗	Ability to include or reference other files from config
Ignore file	✗	✗
IDE integration	✓	✓
Schema / structure	Free-form (Markdown)	Free-form (Markdown)	Whether config uses structured schema or free-form content
Git committed	✓	✓	Whether primary config files are intended to be version-controlled
Encoding	UTF-8	UTF-8

FILE MAPPING

Purpose	Google Antigravity	Augment Code
Project instructions	AGENTS.md	AGENTS.md
Project instructions	GEMINI.md	.augment-guidelines.md

SIDE-BY-SIDE CODE SAMPLES

Google Antigravity

AGENTS.md

markdown

# Project Instructions

## Architecture
- Monorepo with apps/ and packages/ directories
- Each app is a standalone Next.js deployment
- Shared packages use TypeScript project references

## Code Standards
- TypeScript strict mode everywhere
- Use Zod for runtime validation at API boundaries
- Prefer server components; use "use client" only when needed
- All database queries go through the data-access layer

## Testing
- Unit tests with Vitest for business logic
- Integration tests for API routes
- E2E tests with Playwright for critical user flows

## Deployment
- Preview deployments on every PR
- Production deploys from main branch only
- Environment variables managed via .env.local (never committed)

Augment Code

AGENTS.md

markdown

# Project Rules

## Architecture
- Clean architecture with domain, application, and infrastructure layers
- Domain models must not import from infrastructure
- Use dependency injection for all services

## Code Style
- TypeScript strict mode, no implicit any
- Use Result<T, E> for error handling in domain layer
- Prefer composition over inheritance
- Maximum 3 parameters per function; use options objects for more

## Testing
- Unit tests for domain logic (no mocking frameworks)
- Integration tests for API endpoints
- E2E tests for critical user journeys with Playwright

## Dependencies
- Do not add new dependencies without discussing first
- Prefer standard library over third-party for simple tasks

KEY DIFFERENCES

1. Global config

Google Antigravity: Not supported. Augment Code: Supported.

WHICH SHOULD I USE?

Recommendation

Choose based on your IDE/CLI preference. If you use Google Antigravity, configure AGENTS.md. If you use Augment Code, configure AGENTS.md. Many projects include config files for multiple tools so each team member can use their preferred editor.

PORTABILITY TIP

sync-instructions.sh

bash

# Maintain a single source of truth:
cp AI-INSTRUCTIONS.md CLAUDE.md
cp AI-INSTRUCTIONS.md .cursorrules
cp AI-INSTRUCTIONS.md AGENTS.md