Skip to main content

Overview

The ag-kit init command installs the .agent folder containing all Antigravity Kit templates (agents, skills, and workflows) into your project directory.
npx @vudovn/ag-kit init

Options

--force
flag
Overwrite existing .agent folder if it already exists. Use this to force reinstallation.
--path
string
Install in a specific directory instead of the current working directory.Example: --path ./myapp
--branch
string
Use a specific branch from the repository instead of the default branch.Example: --branch dev
--quiet
flag
Suppress output messages. Useful for CI/CD pipelines and automated scripts.
--dry-run
flag
Preview the actions that would be performed without actually executing them.

Usage Examples

Basic Installation

Install Antigravity Kit in the current directory:
ag-kit init
Output:
Installing Antigravity Kit...
✓ Created .agent/ directory
✓ Installed 20 agents
✓ Installed 37 skills
✓ Installed 11 workflows
Successfully installed Antigravity Kit!

Force Reinstallation

Overwrite an existing installation:
ag-kit init --force
Output:
Warning: Existing .agent/ folder will be overwritten
Installing Antigravity Kit...
✓ Removed old installation
✓ Created .agent/ directory
✓ Installed 20 agents
✓ Installed 37 skills
✓ Installed 11 workflows
Successfully installed Antigravity Kit!

Custom Installation Path

Install in a specific project directory:
ag-kit init --path ./myapp
Output:
Installing Antigravity Kit in ./myapp...
✓ Created .agent/ directory
✓ Installed 20 agents
✓ Installed 37 skills
✓ Installed 11 workflows
Successfully installed Antigravity Kit!

Development Branch

Install from a specific branch:
ag-kit init --branch dev

Silent Installation for CI/CD

Run without output for automated pipelines:
ag-kit init --quiet

Preview Installation

See what would be installed without making changes:
ag-kit init --dry-run
Output:
[DRY RUN] Would create .agent/ directory
[DRY RUN] Would install 20 agents
[DRY RUN] Would install 37 skills
[DRY RUN] Would install 11 workflows

Combining Options

You can combine multiple options:
ag-kit init --path ./myapp --force --branch dev

What Gets Installed

The init command installs the following components:
ComponentCountDescription
Agents20Specialist AI personas (frontend, backend, security, PM, QA, etc.)
Skills37Domain-specific knowledge modules
Workflows11Slash command procedures

Important Notes

If you are using AI-powered editors like Cursor or Windsurf, avoid adding the .agent/ folder to your .gitignore. This may prevent the IDE from indexing the workflows, causing slash commands (like /plan, /debug) to not appear in the chat suggestion dropdown.
To keep the .agent/ folder local (not tracked by Git) while maintaining AI functionality:
  1. Ensure .agent/ is NOT in your project’s .gitignore
  2. Instead, add it to your local exclude file: .git/info/exclude

After Installation

Once installation is complete, you can:
  • Use 20 specialist agents that are automatically detected and applied
  • Run 11 workflow slash commands (/plan, /debug, /create, etc.)
  • Leverage 37 skills that load automatically based on task context
Run ag-kit status to verify your installation.

Build docs developers (and LLMs) love