Version 3.0.0 - Initial Release

SuperClaude v3

A framework that extends Claude Code with 16 specialized commands, smart personas, and MCP server integration

Open Source (MIT)

PyPI Available

100% Local

⚠️ Fresh Out of Beta!

This is an initial release - bugs may occur as we continue improving. Perfect for experimentation and development workflows! 😊

What Makes SuperClaude v3 Special?

Built from the ground up with a focus on simplicity, reliability, and performance

Specialized Commands

Essential commands for the most common development tasks

/sc:implement, /sc:build, /sc:design

/sc:analyze, /sc:troubleshoot

/sc:test, /sc:improve

Smart Personas

Domain specialists that jump in when relevant

🏗️ architect - Systems design

🎨 frontend - UI/UX focus

🛡️ security - Vulnerability analysis

MCP

Server Integration

External tools that connect when useful

Context7 - Official docs

Sequential - Multi-step thinking

Magic - UI components

What's Working Well

Installation suite (rewritten from ground up)
Core framework with 9 documentation files
16 slash commands for development tasks
MCP server integration (Context7, Sequential, Magic, Playwright)
Unified CLI installer for easy setup

Known Issues

Initial release - bugs are expected
Some features may not work perfectly yet
Documentation is still being improved
Hooks system was removed (coming back in v4)

Installation Guide

Two-step process: Install the package, then run the installer

Install the Package

Option A: From PyPI (Recommended)

uv add SuperClaude

Option B: From Source

git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
uv sync

Run the Installer

# Quick setup (recommended)
SuperClaude install

# Interactive selection
SuperClaude install --interactive

# Developer setup
SuperClaude install --profile developer

That's it! 🎉 The installer handles everything: framework files, MCP servers, and Claude Code configuration.

⚠️ Upgrading from v2? Important!

Clean up first: Uninstall v2 and delete SuperClaude/, ~/.claude/shared/, ~/.claude/commands/

Key Change: /build is now /sc:implement for feature implementation

Migration: Replace v2 /build myFeature with v3 /sc:implement myFeature

📚 Next Steps: Documentation & Guides

After installation, check out these comprehensive guides to get the most out of SuperClaude v3:

User Guide

Complete overview & getting started

Commands Guide

All 16 slash commands explained

Personas Guide

Understanding the persona system

Installation Guide

Detailed installation instructions

Flags Guide

Command flags and options

Contributing

How to contribute to the project

16 Essential Commands

Development

/sc:implementBuild features

/sc:buildCompile/package

/sc:designUI/UX design

Analysis

/sc:analyzeCode analysis

/sc:troubleshootDebug issues

/sc:explainCode explanation

Quality

/sc:improveCode enhancement

/sc:testTesting suites

/sc:cleanupCode cleanup

Utilities

/sc:documentDocumentation

/sc:gitGit operations

/sc:estimateTime estimates

/sc:taskTask management

Smart Personas

🏗️

architect

Systems design and architecture planning

🎨

frontend

UI/UX and accessibility focused development

⚙️

backend

APIs and infrastructure development

🔍

analyzer

Debugging and problem-solving specialist

🛡️

security

Security concerns and vulnerability assessment

✍️

scribe

Documentation and technical writing

+ 3 more specialists that jump in when relevant!
They don't always pick perfectly, but usually get it right! 😊

SuperClaude Contributors

Amazing developers who make SuperClaude possible

Loading... contributors and counting! View all contributors →

SuperClaude_Website Contributors

Amazing developers who make SuperClaude_Website possible

NomenAK

Project Creator & Lead Developer

Python Framework

Mithun Gowda B

Collaborator & Contributor

Development Testing

Contributors

Community Members

Docs Testing

Join Us!

Become a Contributor

Welcome Open

Sponsor

Support Development

GitHub ❤️

Want to Contribute?

We welcome contributions of all kinds! From bug reports to new features, documentation improvements to code reviews.

Report Issues Contribute Code

Frequently Asked Questions

Why was the hooks system removed?

It was getting complex and buggy. We're redesigning it properly for v4.

Does this work with other AI assistants?

Currently Claude Code only, but v4 will have broader compatibility.

Is this stable enough for daily use?

The basic stuff works pretty well, but definitely expect some rough edges since it's a fresh release. Probably fine for experimenting! 🧪

How does SuperClaude ensure privacy?

SuperClaude runs 100% locally with no third-party servers or data collection. It's open source and MIT licensed.

What's coming in v4?

We're hoping to work on hooks system redesign, more MCP integrations, better performance, additional personas, and cross-CLI support. No timeline promises though! 😅