🚀 SuperGravity

The Ultimate Framework for Google Antigravity IDE

Transform your AI-powered development experience with structured workflows, intelligent skills, and seamless MCP integrations.

Quick Start • Features • Workflows • Skills • MCP Servers • Docs

---

🎯 What is SuperGravity?

SuperGravity supercharges Google Antigravity IDE by providing a structured, enterprise-ready development framework. It bridges the gap between AI assistance and professional software development practices.

┌─────────────────────────────────────────────────────────────────┐
│                     🚀 SUPERGRAVITY                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐            │
│   │  9 Global   │  │  12 AI      │  │  10 MCP     │            │
│   │  Workflows  │  │  Skills     │  │  Servers    │            │
│   └──────┬──────┘  └──────┬──────┘  └──────┬──────┘            │
│          │                │                │                    │
│          └────────────────┼────────────────┘                    │
│                           ▼                                     │
│              ┌────────────────────────┐                         │
│              │  Google Antigravity    │                         │
│              │        IDE             │                         │
│              └────────────────────────┘                         │
│                           │                                     │
│                           ▼                                     │
│              ┌────────────────────────┐                         │
│              │   Your Project         │                         │
│              │   .agent/ workspace    │                         │
│              └────────────────────────┘                         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

✨ Features

your-project/
└── .agent/
    ├── rules/      # Project rules
    ├── workflows/  # Custom workflows
    └── skills/     # Custom skills

📦 Installation

From PyPI (Recommended)

pip install supergravity

From Source

git clone https://github.com/mithun50/SuperGravity.git
cd SuperGravity
pip install -e .

Using pipx (Isolated Environment)

pipx install supergravity

🚀 Quick Start

# 1. Install SuperGravity to Antigravity IDE
supergravity install

# 2. Initialize your project workspace
cd your-project
supergravity init

# 3. Add MCP servers for enhanced capabilities
supergravity mcp setup

# 4. Check everything is working
supergravity status

Then restart Antigravity IDE and start using workflows:

/scaffold nextjs e-commerce app with auth
/implement user authentication with JWT
/security scan src/ for vulnerabilities
/test generate tests for UserService

🛠️ CLI Commands

Core Commands

MCP Commands

🔄 Workflows

Type /workflow-name in Antigravity chat:

🧠 Skills

Skills activate automatically based on your request context:

🔌 MCP Servers

No API Key Required

API Key Required

Interactive Setup

supergravity mcp setup

Supports multiple selection formats:

• 1 2 3 - Space-separated
• 1,2,3 - Comma-separated
• 1-3 - Ranges
• 1, 3-5, 7 - Mixed

📁 Configuration

Global Configuration

~/.gemini/
├── GEMINI.md                    # Global rules
└── antigravity/
    ├── mcp_config.json          # MCP server configuration
    ├── mcp_registry.json        # MCP tracking (auto-generated)
    ├── global_workflows/        # Global workflow definitions
    └── skills/                  # AI skill definitions

Workspace Configuration

your-project/
└── .agent/
    ├── rules/                   # Project-specific rules
    │   └── workspace.md
    ├── workflows/               # Project-specific workflows
    │   ├── dev.md
    │   ├── build.md
    │   └── pr.md
    └── skills/                  # Project-specific skills

💻 Platform Support

Windows

# Option 1: Python module syntax (always works)
python -m supergravity install
python -m supergravity mcp setup

# Option 2: Add Scripts to PATH
# Add %USERPROFILE%\AppData\Local\Programs\Python\PythonXX\Scripts

# Option 3: Use pipx (recommended)
pipx install supergravity

Linux / macOS

pip install supergravity
supergravity install

🔧 Troubleshooting

# Check installation status
supergravity status

# Force reinstall
supergravity install --force

# Check prerequisites
supergravity mcp prereq

# Verify servers
supergravity mcp verify

# Reinstall a server
supergravity mcp remove context7
supergravity mcp add context7

📚 Documentation

🤝 Contributing

We welcome contributions! Here's how to get started:

# Clone the repository
git clone https://github.com/mithun50/SuperGravity.git
cd SuperGravity

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Format code
black supergravity/
isort supergravity/

CI/CD

• Tests: Run automatically on Windows, macOS, and Linux with Python 3.8-3.12
• Publishing: Automatic PyPI release on GitHub Release creation

📊 Project Stats

👨‍💻 Author

Mithun Gowda B

📄 License

⚠️ Disclaimer