🚀 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

🔄 9 Global Workflows

Slash commands for common development tasks:

/scaffold - Generate project structures
/implement - Build features with patterns
/security - OWASP security audits
/test - Comprehensive test generation
/deploy - Safe deployments
/review - Code quality reviews
/document - Auto documentation
/refactor - Safe refactoring
/debug - Systematic debugging

🧠 12 AI Skills

Specialized capabilities that activate on-demand:

fullstack-architect
backend-engineer
frontend-specialist
api-designer
database-expert
security-engineer
test-engineer
devops-engineer
code-reviewer
refactoring-expert
performance-optimizer
documentation-writer

🔌 10 MCP Servers

Pre-configured tool integrations:

context7 - Framework docs
sequential-thinking - Complex reasoning
playwright - Browser automation
magic - UI generation
tavily - Web search
firecrawl - Web scraping
github - GitHub operations
postgres - Database operations
filesystem - File operations
memory - Persistent memory

📁 Workspace Support

Initialize projects with .agent/ structure:

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

Features:

Project-specific configurations
Custom workflow creation
Local skill definitions
Team-shareable settings

📦 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

Command	Description
`supergravity install`	Install SuperGravity to Antigravity IDE
`supergravity install --force`	Force reinstall (overwrites files)
`supergravity uninstall`	Remove SuperGravity
`supergravity update`	Update workflows and rules
`supergravity status`	Check installation status
`supergravity init`	Initialize `.agent/` workspace
`supergravity init --path ./myproject`	Initialize specific directory

MCP Commands

Command	Description
`supergravity mcp list`	List all available MCP servers
`supergravity mcp list --installed`	List only installed servers
`supergravity mcp add <server>`	Install and configure an MCP server
`supergravity mcp add <server> -k KEY`	Install with API key
`supergravity mcp remove <server>`	Remove an MCP server
`supergravity mcp setup`	Interactive MCP setup wizard
`supergravity mcp update --all`	Update all installed servers
`supergravity mcp verify`	Verify all servers work
`supergravity mcp prereq`	Check prerequisites (npm, docker)
`supergravity mcp sync`	Sync registry with config

🔄 Workflows

Type /workflow-name in Antigravity chat:

Command	Description	Example
`/scaffold`	Generate project structures	`/scaffold nextjs blog with auth`
`/implement`	Implement features with patterns	`/implement user authentication`
`/security`	Security audit (OWASP Top 10)	`/security scan src/`
`/test`	Generate comprehensive tests	`/test for UserService`
`/deploy`	Deploy applications safely	`/deploy to vercel`
`/review`	Code review with quality checks	`/review changes in api/`
`/document`	Generate documentation	`/document the API`
`/refactor`	Safe refactoring with tests	`/refactor extract method`
`/debug`	Systematic debugging	`/debug login failure`

🧠 Skills

Skills activate automatically based on your request context:

🏗️ Architecture & Design

Skill	Trigger Examples
`fullstack-architect`	"Design a scalable e-commerce system"
`api-designer`	"Create a REST API for users"
`database-expert`	"Design the schema for orders"

💻 Development

Skill	Trigger Examples
`backend-engineer`	"Build the authentication API"
`frontend-specialist`	"Create a responsive dashboard"
`devops-engineer`	"Set up CI/CD pipeline"

🔒 Quality & Security

Skill	Trigger Examples
`security-engineer`	"Audit for vulnerabilities"
`test-engineer`	"Generate unit tests"
`code-reviewer`	"Review this pull request"

🔧 Optimization

Skill	Trigger Examples
`refactoring-expert`	"Refactor this module"
`performance-optimizer`	"Optimize database queries"
`documentation-writer`	"Document this API"

🔌 MCP Servers

No API Key Required

Server	Purpose	Install
`context7`	Framework documentation (React, Next.js, Vue)	`supergravity mcp add context7`
`sequential-thinking`	Complex multi-step reasoning	`supergravity mcp add sequential-thinking`
`playwright`	Browser automation and E2E testing	`supergravity mcp add playwright`
`filesystem`	File system operations	`supergravity mcp add filesystem`
`memory`	Persistent memory across sessions	`supergravity mcp add memory`

API Key Required

Server	Key Required	Get Key
`magic`	`TWENTYFIRST_API_KEY`	21st.dev
`tavily`	`TAVILY_API_KEY`	tavily.com
`firecrawl`	`FIRECRAWL_API_KEY`	firecrawl.dev
`github`	`GITHUB_PERSONAL_ACCESS_TOKEN`	GitHub Settings
`postgres`	`POSTGRES_URL`	Your database

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

Installation Issues

# Check installation status
supergravity status

# Force reinstall
supergravity install --force

MCP Server Issues

# Check prerequisites
supergravity mcp prereq

# Verify servers
supergravity mcp verify

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

Missing Prerequisites

Node.js: Required for MCP servers. Install from nodejs.org (v18+)
Docker: Required for GitHub MCP. Install from docker.com

📚 Documentation

Guide	Description
Skills Guide	Creating and using AI skills
Workflows Guide	Workflow syntax and customization
MCP Servers Guide	MCP setup and configuration
Configuration Reference	All configuration options
Customization Guide	Custom workflows and rules

🤝 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

Metric	Value
Workflows	9 global + unlimited custom
AI Skills	12 built-in + custom support
MCP Servers	10 pre-configured
Python Support	3.8, 3.9, 3.10, 3.11, 3.12
Platforms	Windows, macOS, Linux

👨‍💻 Author

Mithun Gowda B

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This project is not affiliated with or endorsed by Google.

Google Antigravity is a product built by Google.

SuperGravity is an independent, community-driven framework.

⭐ Star this repo if you find it useful!

Made with ❤️ by Mithun Gowda B

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
.github/workflows		.github/workflows
SuperGravity		SuperGravity
bin		bin
docs		docs
global_workflows		global_workflows
rules		rules
supergravity		supergravity
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
MANIFEST.in		MANIFEST.in
README.md		README.md
VERSION		VERSION
install.sh		install.sh
mcp_config.json		mcp_config.json
package.json		package.json
pyproject.toml		pyproject.toml
setup.py		setup.py

Folders and files

Latest commit

History

Repository files navigation

🚀 SuperGravity

The Ultimate Framework for Google Antigravity IDE

🎯 What is SuperGravity?

✨ Features

🔄 9 Global Workflows

🧠 12 AI Skills

🔌 10 MCP Servers

📁 Workspace Support

📦 Installation

From PyPI (Recommended)

From Source

Using pipx (Isolated Environment)

🚀 Quick Start

🛠️ CLI Commands

Core Commands

MCP Commands

🔄 Workflows

🧠 Skills

🔌 MCP Servers

No API Key Required

API Key Required

Interactive Setup

📁 Configuration

Global Configuration

Workspace Configuration

💻 Platform Support

Windows

Linux / macOS

🔧 Troubleshooting

📚 Documentation

🤝 Contributing

CI/CD

📊 Project Stats

👨‍💻 Author

Mithun Gowda B

📄 License

⚠️ Disclaimer

⭐ Star this repo if you find it useful!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages