CLI 3.0 is built on the same unified agent harness that powers the Kiro IDE and Kiro Web. Every improvement to the engine (new tools, better planning, smarter tool selection) now ships to all clients simultaneously.
Spec-driven development -- the Spec agent brings structured development to the terminal. Define requirements, generate designs, execute task plans with checkpoints. Use /spec new <name> to start. Learn more →
Capability-based permissions -- declare structured policies in permissions.yaml for fine-grained, auditable control. One rule can allow or deny an entire category of operations across all tools. Learn more →
Enhanced hooks -- standalone .kiro/hooks/*.json files with two action types (shell commands and agent prompts), new triggers, and a versioned schema. Learn more →
Enhanced agent config -- tag-based tool selection, unified permissions block, Markdown format, inline MCP servers. Learn more →
| Area | What changed |
|---|---|
| Permissions | --trust-all-tools and /tools trust replaced by permissions.yaml |
| Hooks | Embedded hooks moved to standalone .kiro/hooks/*.json, PascalCase triggers |
| Agent config | toolsSettings replaced by permissions field, tool IDs replaced by tags |
| aws_tool | Removed -- use MCP servers instead |
| Session format | v3 format not backward-compatible -- back up ~/.kiro/sessions/ |
| Supervised mode | Removed -- use permissions.yaml |
Try the v3 engine: kiro-cli --v3.
| Gap | Detail |
|---|---|
| AL2 not supported | CLI 3.0 does not run on Amazon Linux 2. Use CLI 2.x if your environment requires AL2. |
| Classic mode not supported | The legacy non-TUI mode (kiro-cli chat without the TUI) does not support the v3 engine. Use the TUI. |
kiro-cli diagnostic -- validates your environment
CLI 3.0 (Early Access)