Skip to main content

Installation

Antigravity Kit can be installed using npm or npx. The installation process adds the .agent folder containing all templates to your project.

Installation Methods

What Gets Installed

The installation creates a .agent folder in your project with the following structure:
.agent/
├── ARCHITECTURE.md          # System documentation
├── agents/                  # 20 Specialist Agents
│   ├── frontend-specialist.md
│   ├── backend-specialist.md
│   ├── database-architect.md
│   ├── security-auditor.md
│   ├── debugger.md
│   └── ... (15 more)
├── skills/                  # 37 Skills
│   ├── react-best-practices/
│   ├── api-patterns/
│   ├── database-design/
│   ├── testing-patterns/
│   └── ... (33 more)
├── workflows/               # 11 Slash Commands
│   ├── brainstorm.md
│   ├── create.md
│   ├── debug.md
│   ├── deploy.md
│   └── ... (7 more)
├── rules/                   # Global Rules
└── scripts/                 # Master Validation Scripts
    ├── checklist.py
    └── verify_all.py

Installation Options

The ag-kit init command supports several options:
ag-kit init --force

Important: .gitignore Configuration

If you are using AI-powered editors like Cursor or Windsurf, adding the .agent/ folder to your .gitignore may prevent the IDE from indexing the workflows. This results in slash commands (like /plan, /debug) not appearing in the chat suggestion dropdown.
To keep the .agent/ folder local (not tracked by Git) while maintaining AI functionality:
1

Remove from .gitignore

Ensure .agent/ is NOT in your project’s .gitignore file.
2

Add to local exclude

Instead, add it to your local exclude file:
echo ".agent/" >> .git/info/exclude
This keeps the folder local without affecting other team members or requiring changes to the shared .gitignore.
The .git/info/exclude file works like .gitignore but is local to your repository clone and not shared with others.

Updating Antigravity Kit

To update to the latest version:
ag-kit update
The update command pulls the latest templates from the repository and overwrites your .agent folder.

CLI Commands Reference

CommandDescription
ag-kit initInstall .agent folder into your project
ag-kit updateUpdate to the latest version
ag-kit statusCheck installation status

Verification

After installation, verify that the .agent folder exists:
ls -la .agent
You should see:
  • agents/ directory with 20 agent files
  • skills/ directory with 37 skill modules
  • workflows/ directory with 11 workflow files
  • scripts/ directory with validation scripts

Next Steps

Now that you’ve installed Antigravity Kit, you’re ready to start using it!

Quick Start Guide

Learn how to use agents, skills, and workflows in your development workflow

Build docs developers (and LLMs) love