Skip to main content

SuperKiro Framework Management Hub - AI-enhanced development framework for Kiro-compatible workflows

Project description

๐Ÿš€ SuperClaude Framework

Transform Claude Code into a Structured Development Platform

Version License PRs Welcome

Website PyPI npm

English ไธญๆ–‡ ๆ—ฅๆœฌ่ชž

Quick Start โ€ข Support โ€ข Features โ€ข Docs โ€ข Contributing


๐Ÿ“Š Framework Statistics

Commands Agents Modes MCP Servers
22 14 6 6
Slash Commands Specialized AI Behavioral Integrations

๐ŸŽฏ 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:

# 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
# 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! ๐Ÿ™

โ˜• Ko-fi

Ko-fi

One-time contributions

๐ŸŽฏ Patreon

Patreon

Monthly support

๐Ÿ’œ GitHub

GitHub Sponsors

Flexible tiers

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

๐Ÿ”ง MCP Server Integration

6 powerful servers working together:

  • Context7 โ†’ Up-to-date documentation
  • Sequential โ†’ Complex analysis
  • Magic โ†’ UI component generation
  • Playwright โ†’ Browser testing
  • Morphllm โ†’ Bulk transformations
  • Serena โ†’ Session persistence

๐ŸŽฏ Behavioral Modes

6 adaptive modes for different contexts:

  • Brainstorming โ†’ Asks right questions
  • Business Panel โ†’ Multi-expert strategic analysis
  • Orchestration โ†’ Efficient tool coordination
  • Token-Efficiency โ†’ 30-50% context savings
  • Task Management โ†’ Systematic organization
  • Introspection โ†’ Meta-cognitive analysis

โšก Optimized Performance

Smaller framework, bigger projects:

  • Reduced framework footprint
  • More context for your code
  • Longer conversations possible
  • Complex operations enabled

๐Ÿ“š Documentation Overhaul

Complete rewrite for developers:

  • Real examples & use cases
  • Common pitfalls documented
  • Practical workflows included
  • Better navigation structure

๐Ÿ“š Documentation

Complete Guide to SuperClaude

๐Ÿš€ Getting Started ๐Ÿ“– User Guides ๐Ÿ› ๏ธ Developer Resources ๐Ÿ“‹ Reference

๐Ÿค Contributing

Join the SuperClaude Community

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

Contributing Guide Contributors


โš–๏ธ License

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

MIT License


โญ Star History

Star History Chart

๐Ÿš€ Built with passion by the SuperClaude community

Made with โค๏ธ for developers who push boundaries

Back to Top โ†‘

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

superkiro-0.0.1.tar.gz (329.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

superkiro-0.0.1-py3-none-any.whl (145.5 kB view details)

Uploaded Python 3

File details

Details for the file superkiro-0.0.1.tar.gz.

File metadata

  • Download URL: superkiro-0.0.1.tar.gz
  • Upload date:
  • Size: 329.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for superkiro-0.0.1.tar.gz
Algorithm Hash digest
SHA256 cfce5afb596c6c732b943c79eb961b277bfc9d55eb2eebb7975d4018d2c37e12
MD5 aeb0c39c13479d6b1c12cf5303e70c99
BLAKE2b-256 c0e0e57855a6883d448c674222111c7089233884288478df9c5422bdc055e1dd

See more details on using hashes here.

File details

Details for the file superkiro-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: superkiro-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 145.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for superkiro-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e5cd45813f0b0e8982c33ebdf83626ee5debf2747eb75b2d010fb2dc6ad93f82
MD5 c2f42dacc470ca57a0888915e4d2d557
BLAKE2b-256 bf27e8480a44b86cdaded9bfc7779b10519ad0a793cb013c980220b5a70ed303

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page