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.2.tar.gz (330.1 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.2-py3-none-any.whl (145.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: superkiro-0.0.2.tar.gz
  • Upload date:
  • Size: 330.1 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.2.tar.gz
Algorithm Hash digest
SHA256 7ba25987311db1928ddead3cbc3e28782902b2ef2d7394a0779425e8a4454ffc
MD5 d3792395abbfa9ad7680ec7ad453dd6c
BLAKE2b-256 96fc246f93a6b7008c1afddaef49a19f91b3b2009cfbe17e2c2f378d37d49bcf

See more details on using hashes here.

File details

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

File metadata

  • Download URL: superkiro-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 145.8 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4131ab3ba6e5f6dd0fc10d2d741cb382af18e388b2a6a0e0e749c6fccc3bb6a9
MD5 be4624c868d96d75c8d0cf96f07aca83
BLAKE2b-256 956e91b5f5965d1b9f89a07a009cf3511f730db1b28279b30491ffc0c0919a94

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