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 sepcific custom agent configuration |
--help | -h | Show help information |
--version | -V | Show version information |
--help-all | Print help for all subcommands |
Start an interactive chat session with a specific agent configuration.
Syntax:
kiro-cli agent [OPTIONS] [COMMAND]
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 agent Note that doing this is potentially destructive to agents that are already in the global agent directories |
set-default | Define a default agent to use when starting a session |
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
Arguments:
| Argument | Description |
|---|---|
--no-interactive | Print first response to STDOUT without interactive mode |
--resume / -r | Resume the previous conversation from this directory |
--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 # Use specific agent kiro-cli chat --agent my-agent "Help me with AWS CLI"
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 |
--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 # 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 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