SuperClaude for Kiro CLI

Easy installation of SuperClaude Framework for Kiro CLI. One command to install, update, or uninstall.

Attribution: This package is an installer for the SuperClaude Framework created by SuperClaude-Org. All command content and framework design belongs to the original authors. This package simply provides a convenient installation mechanism for Kiro CLI users.

Installation

npx superclaude-kiro install

The installer will guide you through selecting which MCP servers to install. By default, 4 core servers are pre-selected and ready to use immediately.

Want MorphLLM Fast Apply? Select it during installation or add it later:

npx superclaude-kiro install --with-morph

Usage

After installation, start Kiro CLI:

kiro-cli chat

Reference SuperClaude commands using #sc-* syntax:

#sc-implement Add user authentication
#sc-analyze Review this code for security issues
#sc-help Show all available commands

Available Commands

| Command | Description | |---------|-------------| | #sc-analyze | Comprehensive code analysis | | #sc-brainstorm | Interactive requirements discovery | | #sc-build | Project building with error handling | | #sc-cleanup | Code cleanup and optimization | | #sc-design | System and component design | | #sc-document | Documentation generation | | #sc-estimate | Development estimates | | #sc-explain | Code explanations | | #sc-git | Git operations | | #sc-implement | Feature implementation | | #sc-improve | Code improvements | | #sc-index | Project documentation generation | | #sc-pm | Project management orchestration | | #sc-research | Deep web research | | #sc-task | Complex task execution | | #sc-test | Test execution | | #sc-troubleshoot | Issue diagnosis | | #sc-workflow | Workflow generation | | #sc-help | Show all commands and flags |

CLI Commands

# Install SuperClaude (interactive MCP server selection)
npx superclaude-kiro install

# Install with options
npx superclaude-kiro install --force           # Overwrite existing
npx superclaude-kiro install --minimal         # Core servers only, no prompts
npx superclaude-kiro install --with-morph      # Include MorphLLM (prompts for API key)
npx superclaude-kiro install --no-interactive  # Skip prompts, use defaults
npx superclaude-kiro install --no-mcp          # Skip MCP server config entirely
npx superclaude-kiro install --no-default      # Don't set as default agent

# Install with MorphLLM API key (for CI/CD)
npx superclaude-kiro install --morph-api-key "your-api-key"

# Update to latest version (preserves your MCP server selections)
npx superclaude-kiro update

# Add MorphLLM during update
npx superclaude-kiro update --with-morph

# Check installation status
npx superclaude-kiro status

# Uninstall
npx superclaude-kiro uninstall

What Gets Installed

• 30 steering files - SuperClaude commands in ~/.kiro/steering/superclaude/
• 4 agents - Specialized agents in ~/.kiro/agents/
  • superclaude - Main framework agent (default)
  • sc-pm - Project Manager agent
  • sc-implement - Implementation agent
  • sc-analyze - Analysis agent
• MCP servers - Your selected servers in ~/.kiro/settings/mcp.json
• Default agent - Set to superclaude in ~/.kiro/settings/cli.json

MCP Server Selection

During installation, you can choose which MCP servers to install:

| Server | Description | Default | |--------|-------------|---------| | sequential-thinking | Structured reasoning and problem-solving | Yes | | context7 | Library documentation lookup | Yes | | playwright | Browser automation and testing | Yes | | serena | Semantic code analysis and editing | Yes | | morphllm-fast-apply | Ultra-fast file editing (requires API key) | No |

MorphLLM Fast Apply

MorphLLM provides ultra-fast file editing at 10,500+ tokens/sec.

To install with MorphLLM:

npx superclaude-kiro install --with-morph

The installer will guide you through:

1. Creating a free account at morphllm.com
2. Getting your API key from dashboard/api-keys
3. Entering your API key securely

For CI/CD (non-interactive):

npx superclaude-kiro install --morph-api-key "your-api-key"

Pricing: Free tier includes 500 requests/month. Paid usage is ~$1/million tokens.

Configuration

All agents are configured with:

• "tools": ["*"] - Access to all tools
• "allowedTools": ["*", "@context7", "@playwright", "@sequential-thinking", "@serena"] - All built-in and MCP tools pre-approved
• "toolsSettings" - Shell and write operations auto-allowed
• "model": "claude-sonnet-4.5" - Claude Sonnet 4.5
• "useLegacyMcpJson": true - Uses global MCP servers

MCP servers are configured with autoApprove arrays for all tools, so you won't be prompted for permission.

Behavioral Modes

Use natural language to activate modes:

| Mode | How to Activate | |------|-----------------| | Think deeply | "think through this step by step" | | Brainstorm | "let's brainstorm this" | | Delegate | "delegate this to sub-tasks" | | Safe mode | "validate carefully before executing" | | Token efficient | "be concise" |

Switching Agents

# In a Kiro session
/agent swap
# Select from: superclaude, sc-pm, sc-implement, sc-analyze

# Or start with a specific agent
kiro-cli chat --agent sc-pm

For Package Maintainers

Update from Claude Code

# Clone this repo
git clone https://github.com/your-org/superclaude-kiro.git
cd superclaude-kiro

# Install dependencies
npm install

# Sync from your local Claude Code installation
npm run sync:claude

# Build distribution files
npm run build

# Bump version and publish
npm version patch
npm publish

Update from GitHub

# Set the repo (optional, defaults to SuperClaude-Org/SuperClaude_Framework)
export SUPERCLAUDE_REPO=your-org/your-repo

# Sync from GitHub
npm run sync:github

# Build and publish
npm run build
npm version patch
npm publish

Requirements

• Node.js 18+
• Kiro CLI installed (~/.kiro directory exists)

Troubleshooting

SuperClaude not loading as default

# Check setting
kiro-cli settings chat.defaultAgent

# Set manually if needed
kiro-cli settings chat.defaultAgent superclaude

MCP servers not working

# List MCP servers
kiro-cli mcp list

# Check config
cat ~/.kiro/settings/mcp.json

# Check status
npx superclaude-kiro status

MorphLLM not working

Run the installer with --with-morph to set up MorphLLM:

npx superclaude-kiro install --force --with-morph

Or check your current status:

npx superclaude-kiro status

Common issues:

• API key must be provided during installation (environment variable expansion doesn't work reliably in Kiro CLI)
• Get your API key from morphllm.com/dashboard/api-keys

Reinstall from scratch

npx superclaude-kiro uninstall
npx superclaude-kiro install --force

Credits & References

• SuperClaude Framework: https://superclaude.netlify.app/
• SuperClaude GitHub: https://github.com/SuperClaude-Org/SuperClaude_Framework
• Kiro CLI Documentation: https://kiro.dev/docs/cli/

This installer package was created to simplify SuperClaude deployment for Kiro CLI users. All credit for the SuperClaude framework, commands, and methodology goes to the original creators.

License

MIT (installer only - SuperClaude Framework has its own license, see original repository)