## π― **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 && 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:**
```bash
# 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.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.
π‘ Troubleshooting PEP 668 Errors
```bash
# 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! π
### **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
- 22 commands covering full lifecycle
- From brainstorming to deployment
- Clean, organized command structure
