SuperClaude for Kiro

Easy installation of SuperClaude Framework for Kiro (CLI and IDE). 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 users.

Installation

npx superclaude-kiro install

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

Usage

After installation, start Kiro:

Kiro CLI:

kiro-cli chat

Kiro IDE: Open the Kiro IDE and start a chat session.

Command Syntax

SuperClaude commands use different prefixes depending on your environment:

| Environment | Syntax | Example | |-------------|--------|---------| | Kiro CLI | #sc-* | #sc-implement Add user auth | | Kiro IDE | /sc-* | /sc-implement Add user auth |

CLI Examples:

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

IDE Examples:

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

Available Commands

| Command | CLI Syntax | IDE Syntax | Description | |---------|------------|------------|-------------| | analyze | #sc-analyze | /sc-analyze | Comprehensive code analysis | | brainstorm | #sc-brainstorm | /sc-brainstorm | Interactive requirements discovery | | build | #sc-build | /sc-build | Project building with error handling | | cleanup | #sc-cleanup | /sc-cleanup | Code cleanup and optimization | | design | #sc-design | /sc-design | System and component design | | document | #sc-document | /sc-document | Documentation generation | | estimate | #sc-estimate | /sc-estimate | Development estimates | | explain | #sc-explain | /sc-explain | Code explanations | | git | #sc-git | /sc-git | Git operations | | implement | #sc-implement | /sc-implement | Feature implementation | | improve | #sc-improve | /sc-improve | Code improvements | | index | #sc-index | /sc-index | Project documentation generation | | pm | #sc-pm | /sc-pm | Project management orchestration | | research | #sc-research | /sc-research | Deep web research | | task | #sc-task | /sc-task | Complex task execution | | test | #sc-test | /sc-test | Test execution | | troubleshoot | #sc-troubleshoot | /sc-troubleshoot | Issue diagnosis | | workflow | #sc-workflow | /sc-workflow | Workflow generation | | help | #sc-help | /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 --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
npx superclaude-kiro install --no-serena-setup # Skip Serena binary install (use uvx fallback)

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

# 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 | | aws-docs | AWS documentation lookup | Yes |

Configuration

All agents are configured with:

• "tools": ["*"] - Access to all tools
• "allowedTools": ["*", "use_subagent", "@context7", "@playwright", "@sequential-thinking", "@serena"] - All built-in tools, subagents, and MCP tools pre-approved
• "toolsSettings" - Shell and write operations auto-allowed
• "includeMcpJson": true - Includes MCP servers from global config
• "model": "claude-opus-4.6" - Uses Claude Opus 4.6 by default (subagents inherit this when spawned with superclaude agent)

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

MCP tools are auto-approved via the agent's allowedTools patterns (e.g., @context7, @playwright).

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://tools.standardbank.co.za/bitbucket/scm/aien/super-claude-kiro.git
cd super-claude-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=aien/super-claude-kiro

# 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)
• uv (auto-installed if missing) - Required for the Serena MCP server. The installer will automatically download and install uv and then use it to install Serena as a persistent binary. To skip this, use --no-serena-setup.

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

Serena not connecting / slow startup

The installer automatically installs Serena as a persistent binary for fast, reliable startup. If Serena isn't working:

# Check if the Serena binary is installed
npx superclaude-kiro status

# Reinstall with Serena setup
npx superclaude-kiro install --force

# Or skip auto-setup and use uvx fallback
npx superclaude-kiro install --force --no-serena-setup

Common issues:

• Windows: "Git executable not found": The installer auto-detects Git's location and injects it into the MCP config's PATH. If Git isn't installed, get it from https://git-scm.com/download/win and re-run the installer.
• Windows timeouts: The default uvx config re-clones Serena's git repo on every startup, causing timeouts. The auto-install fixes this by using a persistent binary.
• Corporate proxy / SSL errors: The installer auto-detects NODE_EXTRA_CA_CERTS and sets SSL_CERT_FILE, REQUESTS_CA_BUNDLE, and GIT_SSL_CAINFO for Python/Git tools.
• uv not found: The installer auto-installs uv. If it fails, install manually: powershell -c "irm https://astral.sh/uv/install.ps1 | iex" (Windows) or curl -LsSf https://astral.sh/uv/install.sh | sh (Unix).
• Serena binary not found after install: Check ~/.local/bin/serena (Unix) or ~/.local/bin/serena.exe (Windows). You may need to restart your terminal for PATH changes.
• Context7 / Sequential Thinking slow on first run: The installer pre-warms npx caches during install. If you still see timeouts, retry — packages are cached after the first download.

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