Skip to content

feat: add Kiro IDE support via config-driven installer #1589

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bmadcode merged 1 commit into from
Feb 8, 2026
Merged

feat: add Kiro IDE support via config-driven installer #1589

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion docs/how-to/install-bmad.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ Pick which AI tools you use:
- Claude Code
- Cursor
- Windsurf
- Kiro
- Others

Each tool has its own way of integrating commands. The installer creates tiny prompt files to activate workflows and agents — it just puts them where your tool expects to find them.
Expand All @@ -63,7 +64,8 @@ your-project/
│ ├── core/ # Required core module
│ └── ...
├── _bmad-output/ # Generated artifacts
└── .claude/ # Claude Code commands (if using Claude Code)
├── .claude/ # Claude Code commands (if using Claude Code)
└── .kiro/ # Kiro steering files (if using Kiro)
Copy link

@augmentcode augmentcode bot Feb 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This tree implies Kiro steering files live directly under .kiro/, but the installer config targets .kiro/steering/; consider reflecting the more specific path here to reduce user confusion.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

```

## Verify Installation
Expand Down
1 change: 1 addition & 0 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ BMad works with any AI coding assistant that supports custom system prompts or p
- **[Claude Code](https://code.claude.com)** — Anthropic's CLI tool (recommended)
- **[Cursor](https://cursor.sh)** — AI-first code editor
- **[Windsurf](https://codeium.com/windsurf)** — Codeium's AI IDE
- **[Kiro](https://kiro.dev)** — Amazon's AI-powered IDE
- **[Roo Code](https://roocode.com)** — VS Code extension
Comment on lines 36 to 40
Copy link

@coderabbitai coderabbitai bot Feb 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🌐 Web query:

Kiro IDE official website current description Amazon

💡 Result:

Official website (Kiro): Kiro describes itself as “Agentic AI development from prototype to production” and says it “brings structure to AI coding with spec-driven development.” [1]

Amazon/AWS: Kiro is developed by Amazon Web Services (AWS). [2]

Sources:
[1] Kiro official site (kiro.dev)
[2] AlternativeTo “Kiro” about page (lists developer as Amazon Web Services, Inc.)

Update Kiro description to reflect current branding.

The URL https://kiro.dev is correct, but the description "Amazon's AI-powered IDE" mischaracterizes the product. Kiro positions itself as "Agentic AI development from prototype to production" with spec-driven development focus. Update the description to align with Kiro's actual branding rather than labeling it generically as an IDE.

🤖 Prompt for AI Agents 
In `@docs/index.md` around lines 36 - 40, Update the Kiro list item text to match
current branding: replace the description "Amazon's AI-powered IDE" with a
phrasing like "Agentic AI development from prototype to production — spec-driven
development" and keep the existing URL `https://kiro.dev`; edit the list entry
that currently reads "**[Kiro](https://kiro.dev)** — Amazon's AI-powered IDE" to
the new branded description so the item accurately reflects Kiro's positioning.


You should be comfortable with basic software development concepts like version control, project structure, and agile workflows. No prior experience with BMad-style agent systems is required—that's what these docs are for.
Expand Down
13 changes: 12 additions & 1 deletion docs/reference/commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,22 @@ That means the authoritative list lives **in your project**, not in a static doc

## Where Commands Are Generated

The installer writes command files into your project (example paths for Claude Code):
The installer writes command files into your project. The location and format depend on your AI tool:

| AI Tool | Location | File Reference Syntax |
| --- | --- | --- |
| Claude Code | `.claude/commands/` | `@path` references |
| Kiro | `.kiro/steering/` | `#[[file:path]]` references with `inclusion: manual` frontmatter |
| Cursor | `.cursor/commands/` | `@path` references |
| Windsurf | `.windsurf/workflows/` | `@{project-root}/path` references |
Copy link

@augmentcode augmentcode bot Feb 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Windsurf row claims @{project-root}/path references, but the current Windsurf workflow template reads files via plain {project-root}/_bmad/... (no @ include), so this table may be inaccurate for Windsurf users.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.


Comment on lines +20 to +26
Copy link

@coderabbitai coderabbitai bot Feb 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Table only covers 4 of 15+ supported platforms.

Users of Cline, Roo, Auggie, Codex, Gemini, GitHub Copilot, and others will look at this table and wonder if their tool is supported. At minimum, add a row for "Other tools" with a note pointing to the installer or platform-codes.yaml, or add a sentence below the table clarifying the table is not exhaustive.

🤖 Prompt for AI Agents 
In `@docs/reference/commands.md` around lines 20 - 26, The table showing supported
AI tools (header row "AI Tool | Location | File Reference Syntax" and entries
like "Claude Code", "Kiro", "Cursor", "Windsurf") only lists 4 of 15+ platforms;
update docs/reference/commands.md by either adding a final row titled "Other
tools" that points readers to the installer or the canonical platform list
(platform-codes.yaml) and explains that other tools (e.g., Cline, Roo, Auggie,
Codex, Gemini, GitHub Copilot) are supported, or add a short sentence below the
table clarifying the table is not exhaustive and linking to the installer and
platform-codes.yaml for the full list.

Example paths for Claude Code:

- `.claude/commands/bmad/<module>/agents/`
- `.claude/commands/bmad/<module>/workflows/`

All tools invoke the same underlying `_bmad/` workflows and agents — only the launcher format differs.

These folders are the **canonical, project-specific command list**.

## Common Commands
Expand Down
2 changes: 1 addition & 1 deletion tools/cli/installers/lib/core/installer.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ class Installer {
}

// Check if this IDE handler has a collectConfiguration method
// (custom installers like Codex, Kilo, Kiro-cli may have this)
// (custom installers like Codex, Kilo may have this)
if (typeof handler.collectConfiguration === 'function') {
await prompts.log.info(`Configuring ${ide}...`);
ideConfigurations[ide] = await handler.collectConfiguration({
Expand Down
326 changes: 0 additions & 326 deletions tools/cli/installers/lib/ide/kiro-cli.js
View file
Open in desktop

This file was deleted.

Loading
Loading