Skip to content

Getting Started

Get up and running with Antigravity AI Kit in 30 seconds.

⚡ Quick Start

npx antigravity-ai-kit init

This automatically copies the .agent/ folder to your project. Done!

Tip: Use npx antigravity-ai-kit init --force to overwrite an existing .agent/ folder. A timestamped backup is created automatically.

🔄 Updating

ag-kit update             # Non-destructive — preserves your customizations
ag-kit update --dry-run   # Preview changes without applying

Prefer ag-kit update over init --force. The update command preserves your session data, ADRs, learning contexts, and customizations.

Option 2: Manual Installation

# 1. Clone the repository
git clone https://github.com/besync-labs/antigravity-ai-kit.git

# 2. Copy .agent/ to your project
cp -r antigravity-ai-kit/.agent/ your-project/.agent/

# 3. Start your session
/status

✅ Verify Installation

After installing, validate your setup with the built-in CLI checks:

ag-kit verify     # Manifest integrity check
ag-kit scan       # Security scan

Both should return clean results. If they report issues, try reinstalling with --force.

🛡️ Safety Guarantees

Antigravity AI Kit only operates within the .agent/ directory. Your project files — source code, configs, tests, platform files — are never touched by init, update, or any CLI command.

First Session

  1. Open your project in your AI-powered IDE (VS Code, Cursor, Windsurf, etc.)
  2. Run the status command:
/status

You should see:

📊 Session Status
├── Active: Yes
├── Context: Loaded
└── Ready for commands

Basic Workflow

1. Plan Your Feature

/plan Add user authentication

The Planner agent creates a validated implementation plan with quality scoring, cross-cutting concerns (security, testing, documentation), and tiered detail based on task complexity.

2. Review the Plan

Review the generated plan in your working directory.

3. Implement

/implement

4. Verify

/verify

Runs all quality gates: build, lint, test, coverage.

Next Steps