SuperKiro 0.1.0

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

🚀 SuperKiro Framework

Transform Claude Code into a Structured Development Platform

Quick Start • Support • Features • Docs • Contributing

---

📊 Framework Statistics

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

---

🎯 Overview

SuperKiro 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 SuperKiro && pipx upgrade SuperKiro && SuperKiro install	✅ Recommended - Linux/macOS
📦 pip	pip install SuperKiro && pip upgrade SuperKiro && SuperKiro install	Traditional Python environments
🌐 npm	npm install -g @bifrost_inc/superclaude && superclaude install	Cross-platform, Node.js users

Custom Install Directory

• You can specify where framework files are installed using --install-dir.
• Examples:
  • SuperKiro install --install-dir ~/mykiro
  • SuperKiro update --install-dir ~/mykiro
  • SuperKiro uninstall --install-dir ~/mykiro
• Default install directory: ~/.kiro
• Tip: Use the same --install-dir for install/update/uninstall to manage one location.

Directory Layout

• Framework root (controlled by --install-dir, default ~/.kiro):
  • Core: <install-dir>/*
  • Commands: <install-dir>/commands/sc/* (customize via --commands-dir)
  • Agents: <install-dir>/agents/* (customize via --agents-dir)
  • Modes: <install-dir>/* (mode files)
  • Logs: <install-dir>/logs/*
• Project steering (per project, installed via kiro-init):
  • .kiro/steering/super_kiro.md
  • .kiro/steering/sk_*.md (agent personas for #<agent> triggers)
  • .kiro/super_kiro/commands/sk_*.md (slash-command steering)
• Notes:
  • --install-dir does not affect project steering. Use SuperKiro kiro-init <project_dir> (or SuperKiro install <project_dir>) to place steering files.
  • Agent triggers use .kiro/steering/sk_*.md in your project, not <install-dir>/agents/*.

Per-Component Directories (Advanced)

• Override where Commands/Agents live under the install root.
• Install examples:
  • SuperKiro install --commands-dir commands/custom-sc
  • SuperKiro install --agents-dir personas
  • SuperKiro install --install-dir ~/mykiro --commands-dir commands/custom-sc --agents-dir personas
• Uninstall examples (use the same overrides to remove):
  • SuperKiro uninstall --components commands --install-dir ~/mykiro --commands-dir commands/custom-sc
  • SuperKiro uninstall --components agents --install-dir ~/mykiro --agents-dir personas
• Notes:
  • Relative paths resolve under --install-dir.
  • Absolute paths are respected as-is (ensure permissions/safety).

Project vs Global

• Project steering (per project):
  • Install/update into a project folder using SuperKiro kiro-init <target_dir> (or SuperKiro install <target_dir>).
  • Files live under <target_dir>/.kiro/steering and <target_dir>/.kiro/super_kiro/commands and are read by Kiro in that project.
  • Not affected by --install-dir.
• Global framework (user-level tools):
  • Install/update/uninstall with SuperKiro install|update|uninstall and optional --install-dir (default ~/.kiro).
  • Components include core, commands, agents, modes, MCP docs.

Uninstall Behavior

• In a project (when ./.kiro exists):
  • Just run SuperKiro uninstall to prune SuperKiro-managed steering files.
  • You no longer need --prune-steering --steering-target ..
• Global uninstall (user-level framework files):
  • Specific components: SuperKiro uninstall --components core commands agents (plus --install-dir if customized).
  • Complete removal: SuperKiro uninstall --complete [--install-dir <dir>].

⚠️ IMPORTANT: Upgrading from SuperClaude V3

If you have SuperClaude V3 installed, you SHOULD uninstall it before installing SuperKiro:

# Uninstall V3 first
Remove all related files and directories :
*.md *.json and commands/

# Then install
pipx install SuperKiro && pipx upgrade SuperKiro && SuperKiro 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 SuperKiro

# Option 2: User installation
pip install --user SuperKiro

# Option 3: Force installation (use with caution)
pip install --break-system-packages SuperKiro

---

💖 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 One-time contributions

🎯 Patreon Monthly support

💜 GitHub 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 SuperKiro

🚀 Getting Started	📖 User Guides	🛠️ Developer Resources	📋 Reference
📝 Quick Start Guide Get up and running fast 💾 Installation Guide Detailed setup instructions	🎯 Commands Reference All 22 slash commands 🤖 Agents Guide 14 specialized agents 🎨 Behavioral Modes 5 adaptive modes 🚩 Flags Guide Control behaviors 🔧 MCP Servers 6 server integrations 💼 Session Management Save & restore state	🏗️ Technical Architecture System design details 💻 Contributing Code Development workflow 🧪 Testing & Debugging Quality assurance	✨ Best Practices Pro tips & patterns 📓 Examples Cookbook Real-world recipes 🔍 Troubleshooting Common issues & fixes

---

🤝 Contributing

Join the SuperKiro 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

---

⚖️ License

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

---

⭐ Star History

---

🚀 Built with passion by the SuperKiro community

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

Back to Top ↑