SuperGemini v4.2.1 🚀

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.

Quick Start

Installation Methods

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 features

Alternative: 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

Usage with Gemini CLI

# Example commands after installation:
/sg:analyze src/
/sg:implement user authentication

Why 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.

What is SuperGemini? 💎

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.

Documentation

Getting Started

• Quick Start Guide
• Installation Guide

User Guides

• 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

Developer Resources

• Technical Architecture
• Contributing Code
• Testing & Debugging

Reference

• Quick Start Practices
• Examples Cookbook
• Troubleshooting

Contributing

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.

License

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

Contributors: View all contributors