A framework that extends Claude Code with specialized commands, personas, and MCP server integration.
🔗 This Fork: Enhanced with a comprehensive blockchain persona for smart contract development, DeFi protocols, and Web3 applications. Based on SuperClaude v3 with additional blockchain-specific capabilities.
📢 Status: Initial release, fresh out of beta! Bugs may occur as we continue improving things.
SuperClaude tries to make Claude Code more helpful for development work by adding:
- 🛠️ 16 specialized commands for common dev tasks (some work better than others!)
- 🎭 12 smart personas including a new blockchain expert for Web3 development
- 🔗 Blockchain specialization for smart contracts, DeFi, gas optimization, and security auditing
- 🔧 MCP server integration for docs, UI components, and browser automation
- 📋 Task management that tries to keep track of progress
- ⚡ Token optimization to help with longer conversations
This fork adds comprehensive blockchain development capabilities to the SuperClaude framework, making it ideal for Web3 developers working with smart contracts and DeFi protocols! 🚀
✅ What's Working Well:
- Installation suite (rewritten from the ground up)
- Core framework with 9 documentation files
- 16 slash commands for various development tasks
- NEW: Blockchain persona with smart contract expertise
- NEW: Security vulnerability detection (50+ patterns)
- NEW: Gas optimization analysis (20+ optimization types)
- NEW: Foundry toolchain integration
- MCP server integration (Context7, Sequential, Magic, Playwright)
- Unified CLI installer for easy setup
- This is an 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)
We focused on 16 essential commands for the most common tasks:
Development: /sc:implement, /sc:build, /sc:design
Analysis: /sc:analyze, /sc:troubleshoot, /sc:explain
Quality: /sc:improve, /sc:test, /sc:cleanup
Others: /sc:document, /sc:git, /sc:estimate, /sc:task, /sc:index, /sc:load, /sc:spawn
AI specialists that try to jump in when they seem relevant:
- 🏗️ architect - Systems design and architecture stuff
- 🎨 frontend - UI/UX and accessibility
- ⚙️ backend - APIs and infrastructure
- 🔍 analyzer - Debugging and figuring things out
- 🛡️ security - Security concerns and vulnerabilities
- 🔗 blockchain - NEW! Smart contracts, DeFi, gas optimization, security auditing
- ✍️ scribe - Documentation and writing
- ...and 5 more specialists
(They don't always pick perfectly, but usually get it right!)
External tools that connect when useful:
- Context7 - Grabs official library docs and patterns
- Sequential - Helps with complex multi-step thinking
- Magic - Generates modern UI components
- Playwright - Browser automation and testing stuff
(These work pretty well when they connect properly! 🤞)
If you're coming from SuperClaude v2, you'll need to clean up first:
- Uninstall v2 using its uninstaller if available
- Manual cleanup - delete these if they exist:
SuperClaude/~/.claude/shared/~/.claude/commands/~/.claude/CLAUDE.md
- Then proceed with v3 installation below
This is because v3 has a different structure and the old files can cause conflicts.
The /build command changed! In v2, /build was used for feature implementation. In v3:
/sc:build= compilation/packaging only/sc:implement= feature implementation (NEW!)
Migration: Replace v2 /build myFeature with v3 /sc:implement myFeature
SuperClaude installation is a two-step process:
- First install the Python package
- Then run the installer to set up Claude Code integration
Option A: From PyPI (Recommended)
uv add SuperClaudeOption B: From Source
git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
uv syncSuperClaude v3 also supports installation via uv (a faster, modern Python package manager) or uvx for cross-platform usage.
Make sure uv is installed:
curl -Ls https://astral.sh/uv/install.sh | shOr follow instructions from: https://github.com/astral-sh/uv
Once uv is available, you can install SuperClaude like this:
uv venv
source .venv/bin/activate
uv pip install SuperClaudeIf you’re using uvx, just run:
uvx pip install SuperClaudeAfter installing, continue with the usual installer step:
python3 -m SuperClaude installOr using bash-style CLI:
SuperClaude installuvprovides better caching and performance.- Compatible with Python 3.8+ and works smoothly with SuperClaude.
Missing Python? Install Python 3.7+ first:
# Linux (Ubuntu/Debian)
sudo apt update && sudo apt install python3 python3-pip
# macOS
brew install python3
# Windows
# Download from https://python.org/downloads/After installing the package, run the SuperClaude installer to configure Claude Code (You can use any of the method):
After installing the SuperClaude.
You can use SuperClaude commands
, python3 -m SuperClaude commands or also python3 SuperClaude commands
# Quick setup (recommended for most users)
python3 SuperClaude install
# Interactive selection (choose components)
python3 SuperClaude install --interactive
# Minimal install (just core framework)
python3 SuperClaude install --minimal
# Developer setup (everything included)
python3 SuperClaude install --profile developer
# See all available options
python3 SuperClaude install --help# Quick setup (recommended for most users)
python3 -m SuperClaude install
# Interactive selection (choose components)
python3 -m SuperClaude install --interactive
# Minimal install (just core framework)
python3 -m SuperClaude install --minimal
# Developer setup (everything included)
python3 -m SuperClaude install --profile developer
# See all available options
python3 -m SuperClaude install --help# Quick setup (recommended for most users)
SuperClaude install
# Interactive selection (choose components)
SuperClaude install --interactive
# Minimal install (just core framework)
SuperClaude install --minimal
# Developer setup (everything included)
SuperClaude install --profile developer
# See all available options
SuperClaude install --helpThat's it! 🎉 The installer handles everything: framework files, MCP servers, and Claude Code configuration.
SuperClaude tries to enhance Claude Code through:
- Framework Files - Documentation installed to
~/.claude/that guides how Claude responds - Slash Commands - 16 specialized commands for different dev tasks
- MCP Servers - External services that add extra capabilities (when they work!)
- Smart Routing - Attempts to pick the right tools and experts based on what you're doing
Most of the time it plays nicely with Claude Code's existing stuff. 🤝
This fork adds comprehensive blockchain development capabilities:
- Auto-activation on
.solfiles and Foundry projects - Security-first approach with comprehensive vulnerability detection
- Gas optimization analysis with quantitative savings estimates
- Foundry integration with native toolchain support
- DeFi expertise for lending, DEX, and staking protocols
- 50+ vulnerability patterns including reentrancy, overflow, access control
- Economic attack modeling for DeFi protocols
- Flash loan protection strategies
- Oracle manipulation detection and mitigation
- Automated security hardening with OpenZeppelin patterns
- Storage layout optimization and packing strategies
- Loop efficiency improvements and computational optimizations
- External call batching and reduction techniques
- Quantitative analysis with before/after measurements
- Real-world impact calculations (potential $10,000+ daily savings)
- Tutorial 1: Complete token development with staking
- Tutorial 2: Advanced DeFi lending protocol
- Security Audit Example: Comprehensive vulnerability analysis
- Gas Optimization Example: 45%+ gas reduction techniques
We're hoping to work on these things for the next version:
- Hooks System - Event-driven stuff (removed from v3, trying to redesign it properly)
- MCP Suite - More external tool integrations
- Better Performance - Trying to make things faster and less buggy
- Cross-Chain Support - Layer 2 and multi-chain development
- Cross-CLI Support - Might work with other AI coding assistants
(No promises on timeline though - we're still figuring v3 out! 😅)
After installation, you can customize SuperClaude by editing:
~/.claude/settings.json- Main configuration~/.claude/*.md- Framework behavior files
Most users probably won't need to change anything - it usually works okay out of the box. 🎛️
Want to learn more? Check out our guides:
- 📚 User Guide - Complete overview and getting started
- 🛠️ Commands Guide - All 16 slash commands explained
- 🏳️ Flags Guide - Command flags and options
- 🎭 Personas Guide - Understanding the persona system
- 📦 Installation Guide - Detailed installation instructions
- 🔗 Blockchain Persona Guide - Complete blockchain development guide
- 📚 Examples & Tutorials - Step-by-step tutorials and real-world examples
- 🛡️ Security Patterns - Vulnerability detection and analysis
- ⛽ Gas Optimization - Advanced optimization techniques
- 🔨 Foundry Integration - Toolchain optimization and templates
These guides have more details than this README and are kept up to date.
We welcome contributions! Areas where we could use help:
- 🐛 Bug Reports - Let us know what's broken
- 📝 Documentation - Help us explain things better
- 🧪 Testing - More test coverage for different setups
- 💡 Ideas - Suggestions for new features or improvements
The codebase is pretty straightforward Python + documentation files.
SuperClaude/
├── setup.py # pypi setup file
├── SuperClaude/ # Framework files
│ ├── Core/ # Behavior documentation (COMMANDS.md, FLAGS.md, etc.)
│ ├── Commands/ # 16 slash command definitions
│ ├── Settings/ # Configuration files
│ ├── Security/ # NEW: Blockchain security analysis
│ └── Foundry/ # NEW: Foundry integration and templates
├── Examples/ # NEW: Tutorials and examples
│ ├── blockchain-tutorials/ # Step-by-step guides
│ └── blockchain-examples/ # Real-world scenarios
├── Docs/ # Enhanced documentation
├── config/ # NEW: Security and optimization patterns
├── test/ # NEW: Test scenarios and fixtures
├── setup/ # Installation system
└── profiles/ # Installation profiles (quick, minimal, developer)
The v3 architecture focuses on:
- Simplicity - Removed complexity that wasn't adding value
- Reliability - Better installation and fewer breaking changes
- Modularity - Pick only the components you want
- Performance - Faster operations with smarter caching
We learned a lot from v2 and tried to address the main pain points.
Q: Why was the hooks system removed?
A: It was getting complex and buggy. We're redesigning it properly for v4.
Q: Does this work with other AI assistants?
A: Currently Claude Code only, but v4 will have broader compatibility.
Q: Is this stable enough for daily use?
A: The basic stuff works pretty well, but definitely expect some rough edges since it's a fresh release. Probably fine for experimenting! 🧪
MIT - See LICENSE file for details
Built by developers who got tired of generic responses. This blockchain-enhanced fork adds comprehensive Web3 development capabilities to SuperClaude v3. Hope you find it useful for your smart contract development! 🙂🔗