# 🚀 SuperClaude Framework ### **Transform Claude Code into a Structured Development Platform**

Quick Start • Support • Features • Docs • Contributing

## 📊 **Framework Statistics** | **Commands** | **Agents** | **Modes** | **MCP Servers** | |:------------:|:----------:|:---------:|:---------------:| | **21** | **14** | **5** | **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 |

## 💖 **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** [](https://ko-fi.com/superclaude) *One-time contributions*

### 🎯 **Patreon** [](https://patreon.com/superclaude) *Monthly support*

### 💜 **GitHub** [](https://github.com/sponsors/SuperClaude-Org) *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**

🚀 Getting Started	📖 User Guides	🛠️ Developer Resources	📋 Reference
- 📝 [**Quick Start Guide**](Docs/Getting-Started/quick-start.md) *Get up and running fast* - 💾 [**Installation Guide**](Docs/Getting-Started/installation.md) *Detailed setup instructions*	- 🎯 [**Commands Reference**](Docs/User-Guide/commands.md) *All 21 slash commands* - 🤖 [**Agents Guide**](Docs/User-Guide/agents.md) *14 specialized agents* - 🎨 [**Behavioral Modes**](Docs/User-Guide/modes.md) *6 adaptive modes* - 🚩 [**Flags Guide**](Docs/User-Guide/flags.md) *Control behaviors* - 🔧 [**MCP Servers**](Docs/User-Guide/mcp-servers.md) *6 server integrations* - 💼 [**Session Management**](Docs/User-Guide/session-management.md) *Save & restore state*	- 🏗️ [**Technical Architecture**](Docs/Developer-Guide/technical-architecture.md) *System design details* - 💻 [**Contributing Code**](Docs/Developer-Guide/contributing-code.md) *Development workflow* - 🧪 [**Testing & Debugging**](Docs/Developer-Guide/testing-debugging.md) *Quality assurance*	- ✨ [**Best Practices**](Docs/Reference/quick-start-practices.md) *Pro tips & patterns* - 📓 [**Examples Cookbook**](Docs/Reference/examples-cookbook.md) *Real-world recipes* - 🔍 [**Troubleshooting**](Docs/Reference/troubleshooting.md) *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](LICENSE) file for details.

## ⭐ **Star History**

### **🚀 Built with passion by the SuperClaude community**

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

Back to Top ↑