SuperGemini is a meta-programming configuration framework that enhances Gemini CLI with structured development capabilities. It provides 18 slash commands in TOML format, 13 specialized AI agents with Persona Mode, behavioral instructions, and workflow automation for systematic software development.
Recommended: pipx (Isolated CLI Tool)
# Install with pipx for clean, isolated environment
pipx install SuperGemini
# Setup SuperGemini for Gemini CLI (Choose one)
SuperGemini install --yes # Express setup (recommended)
SuperGemini install --profile minimal --yes # Fastest (core only)
SuperGemini install --profile full --yes # All featuresAlternative: pip (Traditional Installation)
# Install with pip (may cause dependency conflicts)
pip install SuperGemini
# Or in a virtual environment (recommended if using pip)
python -m venv supergemini-env
source supergemini-env/bin/activate # Linux/Mac
# or: supergemini-env\Scripts\activate # Windows
pip install SuperGemini# Example commands after installation:
/sg:analyze src/
/sg:implement user authenticationWhy pipx? SuperGemini is a standalone CLI tool. Using pipx:
- Prevents dependency conflicts with your projects
- Provides clean uninstallation
- Automatically manages virtual environments
- Keeps your system Python clean
Note for pipx users: If you encounter Node.js/npm detection issues during MCP setup, ensure these tools are available in your system PATH.
SuperGemini transforms Gemini CLI into a structured development platform by providing:
- 18 Slash Commands: TOML-based commands for systematic workflow automation (/sg:analyze, /sg:implement, etc.)
- Persona Mode: 13 specialized AI agents that embody specific roles (system-architect, security-engineer, etc.)
- SuperAgent MCP Support: Optional subagent orchestration via
superagent:gemini, matching SuperClaude’s multi-agent workflows when desired - Behavioral Instructions: Core principles and rules for consistent development practices
- Workflow Automation: Systematic approaches to analysis, implementation, and optimization
Unlike traditional tools, SuperGemini uses Persona Mode where Gemini CLI embodies agent roles rather than spawning separate sub-agents.
- Commands Reference - 18 TOML-based slash commands
- Agents Guide - 13 specialized AI personas
- Behavioral Modes - Context-aware operation modes
- Flags Guide - Command flags and options
- MCP Servers - MCP server integration guide
- Session Management - Session lifecycle management
Current Priorities:
- 📝 Documentation improvements and usage examples
- 🎯 TOML command workflow patterns and best practices
- 🤖 New AI agent personas for specialized domains
- 🧪 Testing and validation for Gemini CLI integration
- 🌐 Translation and internationalization
See CONTRIBUTING.md for detailed contribution guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
Contributors: View all contributors
