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

``bash
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:

`bash
npx superclaude-kiro install --with-morph
`

Usage

After installation, start Kiro CLI:

`bash
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

`bash


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 |

$3

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

To install with MorphLLM:

`bash
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):

`bash
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": ["*", "use_subagent", "@context7", "@playwright", "@sequential-thinking", "@serena", "@morphllm-fast-apply/edit_file"] - All built-in tools, subagents, and MCP tools pre-approved
- "toolsSettings" - Shell and write operations auto-allowed
- "useLegacyMcpJson": true - Uses global MCP servers
- "model": "claude-opus-4.5" - Uses Claude Opus 4.5 by default (subagents inherit this when spawned with superclaude agent)

Note: No default model is set - Kiro CLI remembers your model choice.

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

`bash


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

$3

`bash


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
`

$3

`bash


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

$3

`bash


Check setting

kiro-cli settings chat.defaultAgent

Set manually if needed

kiro-cli settings chat.defaultAgent superclaude
`

$3

`bash


List MCP servers

kiro-cli mcp list

Check config

cat ~/.kiro/settings/mcp.json

Check status

npx superclaude-kiro status
`

$3

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

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

Or check your current status:

`bash
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

$3

`bash
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)