supergravity
v1.0.1
Published
Transform Google Antigravity into a structured development platform
Downloads
10
Maintainers
Readme
🚀 SuperGravity
The Ultimate Framework for Google Antigravity IDE
🎯 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-architectbackend-engineerfrontend-specialistapi-designerdatabase-expertsecurity-engineertest-engineerdevops-engineercode-reviewerrefactoring-expertperformance-optimizerdocumentation-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 skillsFeatures:
- Project-specific configurations
- Custom workflow creation
- Local skill definitions
- Team-shareable settings
📦 Installation
From PyPI (Recommended)
pip install supergravityFrom 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 statusThen 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:
| 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" |
| Skill | Trigger Examples |
|-------|------------------|
| backend-engineer | "Build the authentication API" |
| frontend-specialist | "Create a responsive dashboard" |
| devops-engineer | "Set up CI/CD pipeline" |
| Skill | Trigger Examples |
|-------|------------------|
| security-engineer | "Audit for vulnerabilities" |
| test-engineer | "Generate unit tests" |
| code-reviewer | "Review this pull request" |
| 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 setupSupports multiple selection formats:
1 2 3- Space-separated1,2,3- Comma-separated1-3- Ranges1, 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 definitionsWorkspace 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 supergravityLinux / 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- 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
MIT License © 2025 Mithun Gowda B
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
