This page provides a comprehensive reference for all Kiro CLI commands and their arguments.
These arguments work with any Kiro CLI command:
| Argument | Short | Description |
|---|---|---|
--verbose | -v | Increase logging verbosity (can be repeated: -v, -vv, -vvv) |
--agent | -v | Start a conversation using a specific custom agent configuration |
--help | -h | Show help information |
--version | -V | Show version information |
--help-all | Print help for all subcommands |
Manage agent configurations.
Syntax:
kiro-cli agent [SUBCOMMAND] [OPTIONS]
Subcommands:
| Subcommand | Description |
|---|---|
list | List the available agents |
create | Create an agent config |
edit | Edit an existing agent config |
validate | Validate a config with the given path |
migrate | Migrate profiles to agents (potentially destructive to existing agents) |
set-default | Define a default agent to use when starting a session |
Examples:
kiro-cli agent list kiro-cli agent create my-agent kiro-cli agent edit my-agent kiro-cli agent validate ./my-agent.json kiro-cli agent set-default my-agent
Start an interactive chat session with Kiro. When no subcommand is specified, kiro defaults to kiro-cli chat.
Syntax:
kiro-cli chat [OPTIONS] [INPUT]
Arguments:
| Argument | Description |
|---|---|
--no-interactive | Print first response to STDOUT without interactive mode |
--resume / -r | Resume the previous conversation from this directory |
--resume-picker | Open interactive session picker to choose which session to resume |
--list-sessions | List all saved chat sessions for the current directory |
--delete-session <ID> | Delete a saved chat session by ID |
--agent | Specify which agent to use |
--trust-all-tools | Allow the model to use any tool without confirmation |
--trust-tools | Trust only specified tools (comma-separated list) |
INPUT | The first question to ask (positional argument) |
Examples:
# Start interactive chat kiro-cli # Ask a question directly kiro-cli chat "How do I list files in Linux?" # Non-interactive mode with trusted tools kiro-cli chat --no-interactive --trust-all-tools "Show me the current directory" # Resume previous conversation kiro-cli chat --resume # Open session picker to choose which session to resume kiro-cli chat --resume-picker # List all saved sessions kiro-cli chat --list-sessions # Use specific agent kiro-cli chat --agent my-agent "Help me with AWS CLI"
Translate natural language instructions to executable shell commands using AI.
Syntax:
kiro-cli translate [OPTIONS] [INPUT...]
Arguments:
| Argument | Short | Description |
|---|---|---|
--n | -n | Number of completions to generate (max 5) |
INPUT | Natural language description (positional arguments) |
Examples:
kiro-cli translate "list all files in the current directory" kiro-cli translate "find all Python files modified in the last week" kiro-cli translate "compress all log files older than 30 days" kiro-cli translate -n 3 "search for text in files"
Diagnose and fix common installation and configuration issues.
Syntax:
kiro-cli doctor [OPTIONS]
Arguments:
| Argument | Short | Description |
|---|---|---|
--all | -a | Run all diagnostic tests without fixes |
--strict | -s | Error on warnings |
--format | -f | Output format: plain, json, json-pretty |
Examples:
kiro-cli doctor kiro-cli doctor --all kiro-cli doctor --strict
Update Kiro CLI to the latest version.
Syntax:
kiro-cli update [OPTIONS]
Arguments:
| Argument | Short | Description |
|---|---|---|
--non-interactive | -y | Don't prompt for confirmation |
--relaunch-dashboard | Relaunch dashboard after update (default: true) |
Examples:
kiro-cli update kiro-cli update --non-interactive
Get or set the visual theme for the autocomplete dropdown menu.
Syntax:
kiro-cli theme [OPTIONS] [THEME]
Arguments:
| Argument | Description |
|---|---|
--list | List all available themes |
--folder | Show the theme directory path |
THEME | Theme name: dark, light, system |
Examples:
kiro-cli theme --list kiro-cli theme dark kiro-cli theme light kiro-cli theme system
Manage system integrations for Kiro.
Syntax:
kiro-cli integrations [SUBCOMMAND] [OPTIONS]
Subcommands:
| Subcommand | Description |
|---|---|
install | Install an integration |
uninstall | Uninstall an integration |
reinstall | Reinstall an integration |
status | Check integration status |
Options:
--silent / -s: Suppress status messages--format / -f: Output format (for status command)Examples:
kiro-cli integrations install kiro-cli integrations status kiro-cli integrations uninstall --silent
Manage inline suggestions (ghost text) that appear as you type.
Syntax:
kiro-cli inline [SUBCOMMAND] [OPTIONS]
Subcommands:
| Subcommand | Description |
|---|---|
enable | Enable inline suggestions |
disable | Disable inline suggestions |
status | Show current status |
set-customization | Select a customization model |
show-customizations | Show available customizations |
Examples:
kiro-cli inline enable kiro-cli inline disable kiro-cli inline status kiro-cli inline set-customization kiro-cli inline show-customizations --format json
Authenticate with Kiro.
Syntax:
kiro-cli login [OPTIONS]
Arguments:
| Argument | Description |
|---|---|
--use-device-flow | Use OAuth device flow for authentication |
Examples:
kiro-cli login kiro-cli login --use-device-flow
Sign out of your kiro-cli session.
Syntax:
kiro-cli logout
Display information about the current user and authentication status.
Syntax:
kiro-cli whoami [OPTIONS]
Arguments:
| Argument | Short | Description |
|---|---|---|
--format | -f | Output format: plain, json, json-pretty |
Examples:
kiro-cli whoami kiro-cli whoami --format json
Manage kiro-cli configuration settings.
Syntax:
kiro-cli settings [SUBCOMMAND] [OPTIONS] [KEY] [VALUE]
Arguments:
| Argument | Short | Description |
|---|---|---|
--delete | -d | Delete a setting |
--format | -f | Output format: plain, json, json-pretty |
KEY | Setting key (positional) | |
VALUE | Setting value (positional) |
Subcommands:
| Subcommand | Description |
|---|---|
open | Open settings file in default editor |
list | List configured settings |
list --all | List all available settings with descriptions |
Examples:
# View all settings kiro-cli settings list # View all available settings kiro-cli settings list --all # Get a specific setting kiro-cli settings telemetry.enabled # Set a setting kiro-cli settings telemetry.enabled true # Delete a setting kiro-cli settings --delete chat.defaultModel # Open settings file kiro-cli settings open # JSON output kiro-cli settings list --format json-pretty
Run diagnostic tests to troubleshoot issues.
Syntax:
kiro-cli diagnostic [OPTIONS]
Arguments:
| Argument | Short | Description |
|---|---|---|
--format | -f | Output format: plain, json, json-pretty |
--force | Force limited diagnostic output |
Create a GitHub issue for feedback or bug reports.
Syntax:
kiro-cli issue [OPTIONS] [DESCRIPTION...]
Arguments:
| Argument | Short | Description |
|---|---|---|
--force | -f | Force issue creation |
DESCRIPTION | Issue description (positional) |
Examples:
kiro-cli issue kiro-cli issue "Autocomplete not working in zsh"
Display version information and changelog.
Syntax:
kiro-cli version [OPTIONS]
Arguments:
| Argument | Description |
|---|---|
--changelog | Show changelog for current version |
--changelog=all | Show changelog for all versions |
--changelog=x.x.x | Show changelog for specific version |
Examples:
kiro-cli version kiro-cli version --changelog kiro-cli version --changelog=all kiro-cli version --changelog=1.5.0
Manage Model Context Protocol (MCP) servers.
Syntax:
kiro-cli mcp [SUBCOMMAND] [OPTIONS]
Subcommands:
Add or replace a configured MCP server.
Arguments:
| Argument | Description |
|---|---|
--name | Server name (required) |
--command | Launch command (required) |
--scope | Scope: workspace or global |
--env | Environment variables: key1=value1,key2=value2 |
--timeout | Launch timeout in milliseconds |
--force | Overwrite existing server |
Example:
kiro-cli mcp add --name my-server --command "node server.js" --scope workspace
Remove an MCP server.
Arguments:
| Argument | Description |
|---|---|
--name | Server name (required) |
--scope | Scope: workspace or global |
Example:
kiro-cli mcp remove --name my-server --scope workspace
List configured MCP servers.
Syntax:
kiro-cli mcp list [SCOPE]
Example:
kiro-cli mcp list kiro-cli mcp list workspace kiro-cli mcp list global
Import server configuration from a file.
Arguments:
| Argument | Description |
|---|---|
--file | Configuration file (required) |
--force | Overwrite existing servers |
SCOPE | Scope: workspace or global |
Example:
kiro-cli mcp import --file config.json workspace
Get the status of an MCP server.
Arguments:
| Argument | Description |
|---|---|
--name | Server name (required) |
Example:
kiro-cli mcp status --name my-server
Kiro CLI automatically saves all chat sessions on every conversation turn. You can resume from any previous chat session at any time.
# Resume the most recent chat session kiro-cli chat --resume # Interactively pick a chat session to resume kiro-cli chat --resume-picker # List all saved chat sessions for the current directory kiro-cli chat --list-sessions # Delete a saved chat session kiro-cli chat --delete-session <SESSION_ID>
Use the /chat command to manage sessions:
# Resume a chat session (interactive selector) /chat resume # Save current session to a file /chat save <FILE_PATH> # Load a session from a file /chat load <FILE_PATH>
The .json extension is optional when loading - Kiro will try both with and without the extension.
You can use custom scripts to control where chat sessions are saved to and loaded from. This allows you to store sessions in version control systems, cloud storage, databases, or any custom location.
# Save session via custom script (receives JSON via stdin) /chat save-via-script <SCRIPT_PATH> # Load session via custom script (outputs JSON to stdout) /chat load-via-script <SCRIPT_PATH>
Tips:
Kiro CLI maintains log files for troubleshooting:
Locations:
$TMPDIR/kiro-log/$XDG_RUNTIME_DIR or /tmp/kiro-log/Log Levels:
Set via KIRO_LOG_LEVEL environment variable:
error: Only errors (default)warn: Warnings and errorsinfo: Info, warnings, and errorsdebug: Debug info and abovetrace: All messages including detailed tracesExample:
# Enable debug logging export KIRO_LOG_LEVEL=debug kiro-cli chat # For fish shell set -x KIRO_LOG_LEVEL debug kiro-cli chat
Warning: Log files may contain sensitive information including file paths, code snippets, and command outputs. Be cautious when sharing logs.
CLI commands