CLI changelog

Stay up to date with the latest updates and improvements to Kiro.

Follow us:Bluesky,X,Discord,andLinkedIn
2.4.0CLI

This release gives you finer control over how conversations flow and how the model thinks. Rewind to any earlier prompt to explore a different path, set reasoning effort per model, and manage all your preferences from one unified settings menu. Workspace initialization is also 88% faster.

Rewind conversations

Jump back to any earlier prompt in a conversation and continue from that point in a new session. Use /rewind to pick a turn, then branch off without losing your original thread. This is useful when you want to explore an alternative approach or undo a direction the agent took without starting over from scratch. Learn more ->

Model Reasoning Effort

Control how much thinking the model does with /effort. Choose from five levels: low, medium, high, xhigh, and max. Lower effort means faster, cheaper responses for straightforward tasks; higher effort gives the model more room to reason through complex problems. Learn more ->

Unified Settings Menu

Access theme customization, keyboard shortcuts, and terminal configuration from a single /settings command. Run /settings theme to change colors, /settings keybindings to view shortcuts, or /settings terminal to enable Shift+Enter / Option+Enter for multi-line input. The existing /theme command still works as a shortcut. Learn more ->

2.3.0CLI

This release gives you more control over which MCP servers you can connect to, where Kiro lives, and how the TUI responds to your keystrokes.

OAuth Client ID for MCP Servers

Connect to HTTP-based MCP servers that don't support Dynamic Client Registration by setting a pre-registered oauth.clientId in your MCP config. This unlocks services like Slack, GitHub, and Figma that require manual app registration for OAuth, so you can use their MCP servers without running your own proxy. Learn more ->

KIRO_HOME Environment Variable

Point Kiro at a different directory for global agents, prompts, skills, steering, settings, and sessions by setting KIRO_HOME before launching. This is handy when you manage dotfiles across machines, keep work and personal profiles separate, or need to isolate Kiro's state for containerized environments. Learn more ->

Configurable V2 TUI Keybindings

Remap the cancel, close-menu, and quit actions in the V2 TUI to keys that fit your muscle memory. If Ctrl+C and Esc conflict with your tmux prefix or terminal bindings, you can now pick different keys instead of working around the defaults. Learn more ->

Agent Output Side Channels

Shell commands the agent runs can now stream output through two additional channels. Write to $AGENT_DISPLAY_OUT to show rich progress in the TUI without bloating the agent's context, and write to $AGENT_CONTEXT_OUT to surface lines in the tool result's agent_notes field. Stdout keeps working as before. Learn more ->

2.2.0CLI

This release adds adaptive thinking support so model reasoning carries across turns in a conversation, giving you more coherent answers as context builds. It also fixes a silent failure in subagent tool dispatch when MCP servers update their tool specs mid-execution.

Adaptive Thinking

Kiro CLI now preserves model reasoning across multi-turn conversations. Thought content from earlier turns stays available to the model on subsequent turns, so follow-up answers stay aligned with the reasoning that produced previous responses. You get more coherent multi-step workflows without re-explaining context.

2.1CLI

This release focuses on keeping you in flow: shell output streams as it happens, Tool Search loads MCP tools on demand so your context window stays clear, and skills are now invokable as slash commands. This release also adds device flow authentication for remote environments, RHEL support, and several rendering and stability fixes.

Real-Time Shell Output Streaming

Shell command output now streams to the terminal line by line as it runs, instead of buffering until the process completes. Long-running commands like builds, test suites, and deployments show progress immediately, so you can follow along and catch issues early. Learn more ->

Tool Search loads MCP tools on demand instead of sending every definition with each request, keeping your context window clear when you have many MCP servers configured. Enable it with kiro-cli settings toolSearch.enabled true. Learn more ->

Skills as Slash Commands

Skills defined in .kiro/skills/ are now available as /skill-name slash commands. Type / and the skill name to invoke it directly, giving you quick access to reusable agent instructions without switching agents or copying instructions into your prompt. Learn more ->

Device Flow for Remote Environments

Sign in with Google or GitHub from SSH sessions, containers, and cloud workspaces without port forwarding. The CLI displays a URL and one-time code you enter in any browser — same flow as Builder ID and IAM Identity Center. Learn more ->

Red Hat Enterprise Linux Support

Kiro CLI's terminal UI now runs on Red Hat Enterprise Linux (RHEL). If you're working in enterprise Linux environments, you get the same full-featured terminal UI experience available on other Linux distributions, macOS, and Windows. Learn more ->

2.0CLI

Kiro CLI 2.0 expands platform support to Windows, introduces headless mode for CI/CD automation, graduates the terminal UI from experimental to the default experience, and adds new capabilities across subagents, hooks, and MCP configuration.

Windows Support

Kiro CLI now runs natively on Windows 11. Windows users can now build using the same agentic coding experience available on macOS and Linux — terminal UI, headless mode, custom agents, and MCP servers all included. Install from PowerShell and background auto-updates keep you current. Learn more ->

Headless Mode

Run Kiro CLI non-interactively in CI/CD pipelines, automation scripts, and environments without a browser. Authenticate with an API key via the KIRO_API_KEY environment variable, pass a prompt with --no-interactive, and Kiro executes it end-to-end. Use --trust-all-tools or --trust-tools to grant tool permissions upfront. API key authentication is available for Pro, Pro+, and Power subscribers, and enterprise admins can control API key generation through governance settings. Learn more ->

Terminal UI as Default

The terminal UI is now the default chat interface. It gives you syntax-highlighted markdown, interactive overlay panels, visual tool progress, and a full set of keyboard shortcuts. Use the crew monitor (Ctrl+G) to track subagent activity in real time, /theme to customize colors, /copy for clipboard access over SSH, /transcript to review conversation history in your pager, /guide to switch to the onboarding agent, and /spawn to run parallel agent sessions. Subagents now support task dependencies — for example, analyze a codebase first, then refactor modules, then run tests, with each step waiting for the previous one to finish while independent steps run in parallel. Switch back to the classic interface anytime with --classic or kiro-cli settings chat.ui "classic". Learn more ->

This release brings an experimental refreshed terminal UI behind the --tui flag. The new experience features a live status bar, rich markdown rendering with syntax-highlighted code blocks, interactive panels for managing context and sessions, and contextual overlays for tools and help. You also get /chat new for starting fresh conversations without restarting the CLI, and --list-models for quickly checking which models are available.

New Terminal Experience

Get a richer chat experience with the new TUI. Agent responses render with full markdown, syntax-highlighted code blocks, tables, and nested formatting. Tool calls show descriptive titles and progress indicators as they run. Interactive panels let you browse context, switch sessions, and manage tools without leaving the terminal. The classic interface remains the default, so you can switch back at any time. Try it with kiro-cli --tui or set it permanently with kiro-cli settings chat.ui "tui". Learn more ->

1.27CLI

This release streamlines how you create and manage agents. Describe what you need and Kiro CLI generates your agent config, use the new session settings tool to tweak preferences mid-conversation without editing config files, and control exactly which shell commands you trust with granular scoped permissions.

Simplified Agent Creation

The /agent create command now defaults to AI-assisted mode, merging the previous /agent generate workflow into a single command. Describe what you want your agent to do and Kiro generates the agent configuration for you. Pass --manual to use the previous editor-based creation flow. You can also specify creation arguments directly at invocation time to bypass the interactive menu entirely. Learn more ->

Granular Tool Trust

When Kiro asks to use a tool, you now get an interactive picker to choose how broadly to trust it. For shell commands, select from tiered scopes — trust the exact command, the command with any arguments, or the base command with wildcards. For read and write tools, scope trust to specific file paths, the containing directory, or the entire tool. The picker adapts to each action, skipping tiers that aren't meaningful, and handles chained shell commands automatically. Learn more ->

Session Settings Tool

You can now ask the agent to adjust settings temporarily within your current session — change model preferences, toggle features, or tweak behavior without modifying your config files. All session overrides apply in-memory and reset automatically when the session ends. Learn more ->

1.26.0CLI

This release adds inline file references with @path syntax, dynamic model selection with tab completion, and estimated token usage visibility for tools. It also brings automatic skill loading, improved agent editing, and enhanced context management.

File and Directory References

Include file contents or directory trees directly in your messages using @path syntax. Content is expanded inline before sending, avoiding tool calls and saving tokens. Type @src/main.rs to inject file contents, or @src/ to show a directory tree. Tab completion and syntax highlighting help you reference files quickly. Learn more ->

Dynamic Model Selection

The /model command now supports direct selection with tab completion and fuzzy matching. Type /model clau<Tab> to see matching models, or /model claude-opus-4.6 to switch immediately. Ghost text hints appear as you type. Learn more ->

Tool Context Insights

The /tools command now displays estimated token counts for each tool and totals per origin, helping you understand context window usage from MCP servers and native tools. Learn more ->

1.25.1CLI

This release adds support for authenticating Kiro CLI with Okta or Microsoft Entra ID credentials.

Enterprise SSO with Okta and Entra ID

Enterprise teams can now connect Okta or Microsoft Entra ID alongside AWS IAM Identity Center for centralized access management. Developers authenticate the CLI with their existing corporate credentials through a browser-based OAuth flow. User and group synchronization happens automatically through SCIM provisioning. Configure your IdP once and it works across both Kiro IDE and CLI. Learn more ->

1.25.0CLI

This release adds Agent Client Protocol (ACP) support for integrating Kiro into ACP-compatible IDEs and clients, a Help Agent for instant CLI guidance, and a range of tool and configuration improvements.

Agent Client Protocol (ACP) Support

ACP-compatible editors like JetBrains IDEs and Zed can now use Kiro as a custom agent. Run kiro-cli acp to start Kiro as an ACP-compliant agent that communicates over stdin/stdout using JSON-RPC. Kiro supports standard ACP methods plus extensions for slash commands, MCP tools, and session management. Learn more ->

Help Agent

Get instant answers about Kiro CLI without leaving your conversation. The built-in Help Agent uses documentation to answer questions about commands, tools, settings, and configuration — and can even create config files in .kiro/ for you. Use /help to switch to the Help Agent, or /help How do I configure MCP? to ask directly. Learn more ->

Enterprise Web Tools Governance

Administrators can now disable web_search and web_fetch tools organization-wide. Users see a notification in /tools when web access is disabled by their organization. Learn more ->

Subagent Access Control

New availableAgents and trustedAgents settings give fine-grained control over which agents can be spawned as subagents. Both support glob patterns like test-*. Learn more ->

Exit Codes & Startup Checks

Structured exit codes for scripting and automation. --require-mcp-startup ensures MCP servers are up before your session starts. Learn more ->