🚀 SuperClaude Framework

Transform Claude Code into a Structured Development Platform

📊 Framework Statistics

| Commands | Agents | Modes | MCP Servers | |:------------:|:----------:|:---------:|:---------------:| | 21 | 14 | 6 | 6 | | Slash Commands | Specialized AI | Behavioral | Integrations |

🎯 Overview

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.

⚡ Quick Installation

Choose Your Installation Method

| Method | Command | Best For | |:------:|---------|----------| | 🐍 pipx | pipx install SuperClaude && SuperClaude install | ✅ Recommended - Linux/macOS | | 📦 pip | pip install SuperClaude && SuperClaude install | Traditional Python environments | | 🌐 npm | npm install -g @bifrost_inc/superclaude && superclaude install | Cross-platform, Node.js users |

If you have SuperClaude V3 installed, you SHOULD uninstall it before installing V4:

# Uninstall V3 first
Remove all related files and directories :
*.md *.json and commands/

# Then install V4
pipx install SuperClaude && SuperClaude install

✅ What gets preserved during upgrade:

• ✓ Your custom slash commands (outside commands/sc/)
• ✓ Your custom content in CLAUDE.md
• ✓ Claude Code's .claude.json, .credentials.json, settings.json and settings.local.json
• ✓ Any custom agents and files you've added

⚠️ Note: Other SuperClaude-related .json files from V3 may cause conflicts and should be removed.

# Option 1: Use pipx (Recommended)
pipx install SuperClaude

# Option 2: User installation
pip install --user SuperClaude

# Option 3: Force installation (use with caution)
pip install --break-system-packages SuperClaude

💖 Support the Project

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! 🙏

☕ Ko-fi

One-time contributions

🎯 Patreon

Monthly support

💜 GitHub

Flexible tiers

Your Support Enables:

| Item | Cost/Impact | |------|-------------| | 🔬 Claude Max Testing | $100/month for validation & testing | | ⚡ Feature Development | New capabilities & improvements | | 📚 Documentation | Comprehensive guides & examples | | 🤝 Community Support | Quick issue responses & help | | 🔧 MCP Integration | Testing new server connections | | 🌐 Infrastructure | Hosting & deployment costs |

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! 🙏

🎉 What's New in V4

Version 4 brings significant improvements based on community feedback and real-world usage patterns.

🤖 Smarter Agent System

14 specialized agents with domain expertise:

• Security engineer catches real vulnerabilities
• Frontend architect understands UI patterns
• Automatic coordination based on context
• Domain-specific expertise on demand

📝 Improved Namespace

/sc: prefix for all commands:

• No conflicts with custom commands
• 21 commands covering full lifecycle
• From brainstorming to deployment
• Clean, organized command structure

🔧 MCP Server Integration

6 powerful servers working together:

• Context7 → Up-to-date documentation
• Sequential → Complex analysis
• Magic → UI component generation
• Playwright → Browser testing
• Morphllm → Bulk transformations
• Serena → Session persistence

🎯 Behavioral Modes

5 adaptive modes for different contexts:

• Brainstorming → Asks right questions
• Orchestration → Efficient tool coordination
• Token-Efficiency → 30-50% context savings
• Task Management → Systematic organization
• Introspection → Meta-cognitive analysis

⚡ Optimized Performance

Smaller framework, bigger projects:

• Reduced framework footprint
• More context for your code
• Longer conversations possible
• Complex operations enabled

📚 Documentation Overhaul

Complete rewrite for developers:

• Real examples & use cases
• Common pitfalls documented
• Practical workflows included
• Better navigation structure

📚 Documentation

Complete Guide to SuperClaude

• 📝 Quick Start Guide
  Get up and running fast

• 💾 Installation Guide
  Detailed setup instructions

• 🎯 Commands Reference
  All 21 slash commands

• 🤖 Agents Guide
  14 specialized agents

• 🎨 Behavioral Modes
  6 adaptive modes

• 🚩 Flags Guide
  Control behaviors

• 🔧 MCP Servers
  6 server integrations

• 💼 Session Management
  Save & restore state

• 🏗️ Technical Architecture
  System design details

• 💻 Contributing Code
  Development workflow

• 🧪 Testing & Debugging
  Quality assurance

• ✨ Best Practices
  Pro tips & patterns

• 📓 Examples Cookbook
  Real-world recipes

• 🔍 Troubleshooting
  Common issues & fixes

🤝 Contributing

Join the SuperClaude Community

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

| Priority | Area | Description | |:--------:|------|-------------| | 📝 High | Documentation | Improve guides, add examples, fix typos | | 🔧 High | MCP Integration | Add server configs, test integrations | | 🎯 Medium | Workflows | Create command patterns & recipes | | 🧪 Medium | Testing | Add tests, validate features | | 🌐 Low | i18n | Translate docs to other languages |

⚖️ License

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

⭐ Star History

🚀 Built with passion by the SuperClaude community