| Commands | Agents | Modes | MCP Servers |
|---|---|---|---|
| 26 | 16 | 7 | 8 |
| Slash Commands | Specialized AI | Behavioral | Integrations |
Use the new /sc:help command to see a full list of all available commands.
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:
| 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 |
π‘ Pro Tip: Claude Code reads these files at session start to ensure consistent, high-quality development aligned with project standards.
| Method | Command | Best For |
|---|---|---|
| π pipx | pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install |
β Recommended - Linux/macOS |
| π¦ pip | pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install |
Traditional Python environments |
| π npm | npm install -g @bifrost_inc/superclaude && superclaude install |
Cross-platform, Node.js users |
β οΈ IMPORTANT: Upgrading from SuperClaude V3
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 && pipx upgrade 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.jsonandsettings.local.json - β Any custom agents and files you've added
.json files from V3 may cause conflicts and should be removed.
π‘ Troubleshooting PEP 668 Errors
# 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 SuperClaudeHey, 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! π
|
One-time contributions |
Monthly support |
Flexible tiers |
| 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! π
Version 4 brings significant improvements based on community feedback and real-world usage patterns.
|
16 specialized agents with domain expertise:
|
|
|
8 powerful servers working together:
|
7 adaptive modes for different contexts:
|
|
Smaller framework, bigger projects:
|
Complete rewrite for developers:
|
SuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling autonomous, adaptive, and intelligent web research.
|
Three intelligent strategies:
|
Up to 5 iterative searches:
|
|
Confidence-based validation:
|
Cross-session intelligence:
|
# Basic research with automatic depth
/sc:research "latest AI developments 2024"
# Controlled research depth
/sc:research "quantum computing breakthroughs" --depth exhaustive
# Specific strategy selection
/sc:research "market analysis" --strategy planning-only
# Domain-filtered research
/sc:research "React patterns" --domains "reactjs.org,github.com"| Depth | Sources | Hops | Time | Best For |
|---|---|---|---|---|
| Quick | 5-10 | 1 | ~2min | Quick facts, simple queries |
| Standard | 10-20 | 3 | ~5min | General research (default) |
| Deep | 20-40 | 4 | ~8min | Comprehensive analysis |
| Exhaustive | 40+ | 5 | ~10min | Academic-level research |
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
| π Getting Started | π User Guides | π οΈ Developer Resources | π Reference |
|---|---|---|---|
|
|
|
- π [**Examples Cookbook**](docs/reference/examples-cookbook.md)
*Real-world recipes*
|
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 |
Made with β€οΈ for developers who push boundaries