SuperClaude_Framework
A configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.
- 23.9k stars
- 2k forks
- 70 open issues
- Language: Python
- License: MIT
- updated
Install
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework- Browse the curated list on GitHub or clone it locally.
- Star it to keep new additions on your radar.
Editor's note
SuperClaude Framework is a configuration layer installed on top of Claude Code that adds 30 slash commands, 20 specialized AI agents, 7 behavioral modes, and integrations with 8 MCP servers. Users install it via PyPI or npm, then run commands like `/sc:implement` for code generation, `/sc:research` for web research using the Tavily MCP server, `/sc:test` for structured testing workflows, and `/sc:pm` for project management tasks. The framework works by injecting behavioral instructions and orchestrating components within Claude Code sessions, effectively imposing structured development methodologies on top of Claude's existing capabilities. Optional MCP server integrations include Tavily for live web search and Context7 for documentation lookup. A built-in `superclaude doctor` command verifies the installation state. The framework targets software developers who want more systematic, repeatable workflows within Claude Code, particularly teams that benefit from standardized command structures across the full development lifecycle from brainstorming through deployment.
Awesome Lists overview
🚀 SuperClaude Framework
Transform Claude Code into a Structured Development Platform
Quick Start • Support • Features • Docs • Contributing
📊 Framework Statistics
| Commands | Agents | Modes | MCP Servers |
|---|---|---|---|
| 30 | 20 | 7 | 8 |
| Slash Commands | Specialized AI | Behavioral | Integrations |
30 slash commands covering the complete development lifecycle from brainstorming to deployment.
🎯 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.
Disclaimer
This project is not affiliated with or endorsed by Anthropic. Claude Code is a product built and maintained by Anthropic.
📖 For Developers & Contributors
Essential documentation for working with SuperClaude Framework:
| Document | Purpose | When to Read |
|---|---|---|
| PLANNING.md | Architecture, design principles, absolute rules | Session start, before implementation |
| TASK.md | Current tasks, priorities, backlog | Daily, before starting work |
| KNOWLEDGE.md | Accumulated insights, best practices, troubleshooting | When encountering issues, learning patterns |
| CONTRIBUTING.md | Contribution guidelines, workflow | Before submitting PRs |
| Commands Reference | Complete reference for all 30 /sc:* commands with syntax, examples, workflows, and decision guides | Learning SuperClaude, choosing the right command |
💡 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.
⚡ Quick Installation
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.
Current Stable Version (v4.3.0)
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 doctorAfter 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.shComing in v5.0 (In Development)
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 superclaudeStatus: In development. No ETA has been set.
Enhanced Performance (Optional MCPs)
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 detailsPerformance Comparison:
Without MCPs: Fully functional, standard performance ✅
With MCPs: 2-3x faster, 30-50% fewer tokens ⚡
💖 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.1
Version 4.1 focuses on stabilizing the slash command architecture, enhancing agent capabilities, and improving documentation.
🤖 Smarter Agent System
20 specialized agents with domain expertise:
PM Agent ensures continuous learning through systematic documentation
Deep Research agent for autonomous web research
Security engineer catches real vulnerabilities
Frontend architect understands UI patterns
Automatic coordination based on context
Domain-specific expertise on demand
What people ask about SuperClaude_Framework
What is SuperClaude-Org/SuperClaude_Framework?
SuperClaude-Org/SuperClaude_Framework is awesome lists for the Claude AI ecosystem. A configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies. It has 23.9k GitHub stars and its last recorded update is dated 2026-09-27.
How do I install SuperClaude_Framework?
You can install SuperClaude_Framework by cloning the repository (https://github.com/SuperClaude-Org/SuperClaude_Framework) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is SuperClaude-Org/SuperClaude_Framework safe to use?
Our security agent has analyzed SuperClaude-Org/SuperClaude_Framework and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains SuperClaude-Org/SuperClaude_Framework?
SuperClaude-Org/SuperClaude_Framework is maintained by SuperClaude-Org. The last recorded GitHub activity is dated 2026-09-27, with 70 open issues.
Are there alternatives to SuperClaude_Framework?
Yes. On ClaudeWave you can browse similar awesome lists at /categories/awesome, sorted by popularity or recent activity.
Maintain this repo? Show its Trust Score in your README
The badge shows this repository's current Trust Score and verdict, and links back to this page. It follows the catalogue data: nobody can buy or edit the score it displays.
[](https://claudewave.com/en/repo/superclaude-org-superclaude-framework)<a href="https://claudewave.com/en/repo/superclaude-org-superclaude-framework"><img src="https://claudewave.com/api/badge/superclaude-org-superclaude-framework" alt="ClaudeWave Trust Score for SuperClaude-Org/SuperClaude_Framework" width="320" height="64"></a>