Quick Start • Support • Features • Docs • Contributing

30 slash commands covering the complete development lifecycle from brainstorming to deployment.

SuperClaude is a meta-programming configuration framework that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It provides systematic workflow automation with powerful tools and intelligent agents.

This project is not affiliated with or endorsed by Anthropic. Claude Code is a product built and maintained by Anthropic.

Essential documentation for working with SuperClaude Framework:

💡 Pro Tip: Claude Code reads these files at session start to ensure consistent, high-quality development aligned with project standards.

📚 New to SuperClaude? Start with Commands Reference — it contains visual decision trees, detailed command comparisons, and workflow examples to help you understand which commands to use and when.

IMPORTANT: The TypeScript plugin system described in older documentation is not yet available (planned for v5.0). For current installation instructions, please follow the steps below for v4.x.

SuperClaude currently uses slash commands.

Option 1: pipx (Recommended)

# Install from PyPI
pipx install superclaude

# Install commands (installs all 30 slash commands)
superclaude install

# Install MCP servers (optional, for enhanced capabilities)
superclaude mcp --list         # List available MCP servers
superclaude mcp                # Interactive installation
superclaude mcp --servers tavily --servers context7  # Install specific servers

# Verify installation
superclaude install --list
superclaude doctor

After installation, restart Claude Code to use 30 commands including:

• /sc:research - Deep web research (enhanced with Tavily MCP)
• /sc:brainstorm - Structured brainstorming
• /sc:implement - Code implementation
• /sc:test - Testing workflows
• /sc:pm - Project management
• /sc - Show all 30 available commands

Option 2: Direct Installation from Git

# Clone the repository
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework

# Run the installation script
./install.sh

We are actively working on a new TypeScript plugin system (see issue #419 for details). When released, installation will be simplified to:

# This feature is not yet available
/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude

Status: In development. No ETA has been set.

For 2-3x faster execution and 30-50% fewer tokens, optionally install MCP servers:

# Optional MCP servers for enhanced performance (via airis-mcp-gateway):
# - Serena: Code understanding (2-3x faster)
# - Sequential: Token-efficient reasoning (30-50% fewer tokens)
# - Tavily: Web search for Deep Research
# - Context7: Official documentation lookup
# - Mindbase: Semantic search across all conversations (optional enhancement)

# Note: Error learning available via built-in ReflexionMemory (no installation required)
# Mindbase provides semantic search enhancement (requires "recommended" profile)
# Install MCP servers: https://github.com/agiletec-inc/airis-mcp-gateway
# See docs/mcp/mcp-integration-policy.md for details

Performance Comparison:

• Without MCPs: Fully functional, standard performance ✅
• With MCPs: 2-3x faster, 30-50% fewer tokens ⚡

Hey, let's be real - maintaining SuperClaude takes time and resources.

The Claude Max subscription alone runs $100/month for testing, and that's before counting the hours spent on documentation, bug fixes, and feature development. If you're finding value in SuperClaude for your daily work, consider supporting the project. Even a few dollars helps cover the basics and keeps development active.

Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏

Note: No pressure though - the framework stays open source regardless. Just knowing people use and appreciate it is motivating. Contributing code, documentation, or spreading the word helps too! 🙏

Version 4.1 focuses on stabilizing the slash command architecture, enhancing agent capabilities, and improving documentation.

# List available MCP servers
superclaude mcp --list

# Install specific servers
superclaude mcp --servers tavily context7

# Interactive installation
superclaude mcp

SuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling autonomous, adaptive, and intelligent web research.

# Basic research with automatic depth
/research "latest AI developments 2024"

# Controlled research depth (via options in TypeScript)
/research "quantum computing breakthroughs"  # depth: exhaustive

# Specific strategy selection
/research "market analysis"  # strategy: planning-only

# Domain-filtered research (Tavily MCP integration)
/research "React patterns"  # domains: reactjs.org,github.com

The Deep Research system intelligently coordinates multiple tools:

• Tavily MCP: Primary web search and discovery
• Playwright MCP: Complex content extraction
• Sequential MCP: Multi-step reasoning and synthesis
• Serena MCP: Memory and learning persistence
• Context7 MCP: Technical documentation lookup

We welcome contributions of all kinds! Here's how you can help:

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

_{Made with ❤️ for developers who push boundaries}

Back to Top ↑