🚀 SuperClaude Framework

Transform Claude Code into a Structured Development Platform

Quick Start • Support • Features • Docs • Contributing

📊 Framework Statistics

Use the new /sc:help command to see a full list of all available commands.

🎯 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.

🛡️ CRITICAL: Backup Your Configuration First!

⚠️ DO NOT SKIP THIS STEP ⚠️

The SuperClaude plugin modifies your Claude Code MCP configuration.
Always backup before installing to ensure you can safely rollback if needed.

# Download and run automated backup script
curl -o /tmp/backup-claude.sh https://raw.githubusercontent.com/SuperClaude-Org/SuperClaude_Plugin/main/scripts/backup-claude-config.sh
chmod +x /tmp/backup-claude.sh
/tmp/backup-claude.sh

# Create backup directory
BACKUP_DIR=~/claude-backups/backup-$(date +%Y-%m-%d-%H-%M-%S)
mkdir -p "$BACKUP_DIR"

# Backup global settings
cp ~/.claude/settings.local.json "$BACKUP_DIR/" 2>/dev/null
cp ~/.claude/CLAUDE.md "$BACKUP_DIR/" 2>/dev/null
cp ~/.claude/.credentials.json "$BACKUP_DIR/" 2>/dev/null

# Backup project settings (if in a project directory)
cp .mcp.json "$BACKUP_DIR/" 2>/dev/null
cp -r .claude "$BACKUP_DIR/" 2>/dev/null

echo "✅ Backup created at: $BACKUP_DIR"

# 1. Uninstall plugin
/plugin uninstall sc@superclaude

# 2. Restore your backup (use your actual backup path)
BACKUP_DIR=~/claude-backups/backup-2025-01-07-14-30-25

cp "$BACKUP_DIR/settings.local.json" ~/.claude/
cp "$BACKUP_DIR/CLAUDE.md" ~/.claude/ 2>/dev/null
cp "$BACKUP_DIR/.credentials.json" ~/.claude/ 2>/dev/null

# 3. Restart Claude Code
pkill -9 claude-code
# Then relaunch Claude Code

⚠️ IMPORTANT: Beta Version Notice

This plugin version is currently in BETA.

Critical Compatibility Information:

NOT COMPATIBLE with previous SuperClaude installations:

• pip version (pip install SuperClaude)
• pipx version (pipx install SuperClaude)
• npm version (npm install -g @bifrost_inc/superclaude)
• uv version (uv tool install SuperClaude)

Required Steps Before Installation:

1. ✅ BACKUP your configuration (see section above)

2. UNINSTALL previous versions:

   # For pip users
   pip uninstall SuperClaude
   
   # For pipx users
   pipx uninstall SuperClaude
   
   # For npm users
   npm uninstall -g @bifrost_inc/superclaude
   
   # For uv users
   uv tool uninstall SuperClaude

3. THEN proceed with plugin installation

⚠️ Beta Limitations:

• May contain bugs or incomplete features
• Configuration format may change
• Not recommended for production-critical work yet
• Feedback and issue reports are highly appreciated!

⚡ Quick Installation

SuperClaude is available as a native Claude Code plugin for easy installation and automatic updates.

# Add the SuperClaude marketplace
/plugin marketplace add SuperClaude-Org/SuperClaude_Plugin

# Install the plugin
/plugin install sc@SuperClaude-Org

# Restart Claude Code to activate

Plugin Benefits:

• ✅ Simple Installation: One command, no Python/Node.js required
• ✅ Automatic Updates: Managed by Claude Code
• ✅ No Conflicts: Isolated from system packages
• ✅ Team Sharing: Easy distribution via marketplace
• ✅ Native Integration: Seamless Claude Code experience
• ✅ Auto MCP Setup: AIRIS MCP Gateway configured automatically

MCP Server Setup

The plugin automatically configures AIRIS MCP Gateway with 10 integrated tools.

⚠️ IMPORTANT: Backup Existing MCP Configuration

If you have existing MCP servers configured, backup your settings first:

# Backup Claude Code MCP settings
cp ~/.claude/settings.local.json ~/.claude/settings.local.json.backup

# Or backup project-specific MCP config
cp .mcp.json .mcp.json.backup  # If you have project MCP config

The plugin adds AIRIS MCP Gateway to your configuration. Review for conflicts with existing MCP servers before enabling.

Setup Options:

Option 1: AIRIS MCP Gateway (Recommended - One-Step Setup)

Unified endpoint for 25+ MCP servers with 90% token reduction:

# 1. Install airis-workspace CLI
brew install agiletec-inc/tap/airis-workspace

# 2. Clone and start the Gateway
git clone https://github.com/agiletec-inc/airis-mcp-gateway.git
cd airis-mcp-gateway
airis up

# 3. Connect to Claude Code
claude mcp add --transport http airis-mcp-gateway http://api.gateway.localhost:9400/api/v1/mcp

Benefits:

• ✅ 25+ servers in one endpoint
• ✅ 90% token reduction via schema partitioning
• ✅ Native HTTP transport (no Docker bridge)
• ✅ Hot-reload server management

Option 2: Individual Server Setup (Advanced)

For users who prefer individual server control:

# Install uvx (required for individual MCP servers)
pip install uv
# or
brew install uv

Verify Setup:

/sc:setup-mcp   # Interactive setup wizard
/sc:verify-mcp  # Check MCP status

Optional API Keys (for premium features):

# Tavily (web search) - Get key at https://tavily.com
export TAVILY_API_KEY="your-key"

# Magic (UI generation) - Get key at https://21st.dev
export TWENTYFIRST_API_KEY="your-key"

Quick Start

After installation, restart Claude Code and try:

# See all commands
/sc:help

# Start brainstorming
/sc:brainstorm "your project idea"

# Analyze codebase
/sc:analyze

# Deep research
/sc:research "your topic"

💖 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:

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.

git clone https://github.com/agiletec-inc/airis-mcp-gateway.git
cd airis-mcp-gateway && just up
claude mcp add --transport http airis-mcp-gateway http://api.gateway.localhost:9400/api/v1/mcp

/plugin marketplace add agiletec-inc/airis-agent
/plugin install airis-agent

🔬 Deep Research Capabilities

Autonomous Web Research Aligned with DR Agent Architecture

SuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling autonomous, adaptive, and intelligent web research.

Research Command Usage

# 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"

Research Depth Levels

Integrated Tool Orchestration

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

📚 Documentation

Complete Guide to SuperClaude

🔧 Development

Automated Sync System

This plugin is automatically synchronized from the SuperClaude_Framework repository every 6 hours using an intelligent namespace isolation system with change detection.

Key Features:

• ✅ Automatic namespace isolation (sc: prefix for command headers, sc- prefix for agent names in frontmatter)
• ✅ Change detection (skips sync when Framework is unchanged via git ls-remote)
• ✅ Safe MCP configuration merging (preserves your custom servers)
• ✅ Validation and rollback (automatic rollback on errors)
• ✅ Detailed sync reports (full audit trail of changes)

How It Works:

1. Change Detection: GitHub Actions checks Framework HEAD via git ls-remote (fast, no clone needed)
2. Transformation: Command headers get sc: prefix, agent names get sc- prefix in frontmatter
3. Validation: All changes validated before commit
4. Auto-commit: Changes automatically committed if valid

For Developers:

# Test sync locally (dry run - no changes)
python scripts/sync_from_framework.py --dry-run true

# Run full sync manually
python scripts/sync_from_framework.py --output-report sync-report.json

# View sync report
cat sync-report.json | jq '.'

📖 Full Documentation: docs/SYNC_SYSTEM.md

🤝 Contributing

Join the SuperClaude Community

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

⚖️ License

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

⭐ Star History

🚀 Built with passion by the SuperClaude community

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

Back to Top ↑