Kiro CLI Cheatsheet: CLI Commands
Kiro is an AI-powered developer CLI that lets you chat with an AI assistant directly in your terminal. It can write code, explain concepts, run shell commands, and integrate with your project via MCP servers and custom agents. The binary is kiro-cli.
Global Flags
| Flag | Short | Description |
|---|---|---|
--verbose | -v | Increase log verbosity (repeat: -vv, -vvv) |
--agent <name> | Start session with a specific agent | |
--help | -h | Show help |
--version | -V | Show version |
--help-all | Print help for all subcommands |
Authentication
1kiro-cli login # Authenticate with Kiro
2kiro-cli login --use-device-flow # OAuth device flow (headless environments)
3kiro-cli logout # Sign out
4kiro-cli whoami # Show current user info
5kiro-cli whoami --format json # JSON outputChat
1kiro-cli # Start interactive chat (default)
2kiro-cli chat # Same as above
3kiro-cli chat "Your question" # Start chat with an initial prompt
4
5# Session management
6kiro-cli chat --resume # Resume most recent session
7kiro-cli chat --resume-picker # Interactively pick session to resume
8kiro-cli chat --list-sessions # List saved sessions for current directory
9kiro-cli chat --delete-session <ID> # Delete a session by ID
10
11# Non-interactive / scripting
12kiro-cli chat --no-interactive "Show current dir" # Print response to STDOUT only
13kiro-cli chat --no-interactive --trust-all-tools "Run ls"
14
15# Tool trust
16kiro-cli chat --trust-all-tools # Trust all tools (no confirmation)
17kiro-cli chat --trust-tools read,write # Trust specific tools only
18
19# Agent
20kiro-cli chat --agent my-agent "Help me with AWS"
21
22# MCP
23kiro-cli chat --require-mcp-startup # Exit with code 3 if MCP server fails
24
25# Display
26kiro-cli chat --wrap always/never/autoTranslate (Natural Language → Shell)
1kiro-cli translate "list all files in current directory"
2kiro-cli translate "find Python files modified in the last week"
3kiro-cli translate -n 3 "search for text in files" # Generate 3 alternatives (max 5)Agents
1kiro-cli agent list # List available agents
2kiro-cli agent create my-agent # Create a new agent
3kiro-cli agent edit my-agent # Edit an agent config
4kiro-cli agent validate ./my-agent.json # Validate agent config
5kiro-cli agent set-default my-agent # Set default agent for new sessions
6kiro-cli agent migrate # Migrate old profiles to agentsAgent config locations:
- Global:
~/.kiro/agents/ - Per-workspace:
.kiro/agents/
MCP (Model Context Protocol)
1# Add a server
2kiro-cli mcp add \
3 --name my-server \
4 --command "node server.js" \
5 --scope workspace \
6 --env KEY=val,KEY2=val2 \
7 --timeout 5000 \
8 --force
9
10# Remove a server
11kiro-cli mcp remove --name my-server --scope global
12
13# List servers
14kiro-cli mcp list
15kiro-cli mcp list workspace
16kiro-cli mcp list global
17
18# Import config
19kiro-cli mcp import --file config.json workspace --force
20
21# Server status
22kiro-cli mcp status --name my-serverSettings
1kiro-cli settings list # List configured settings
2kiro-cli settings list --all # All available settings with descriptions
3kiro-cli settings telemetry.enabled # Get a setting value
4kiro-cli settings telemetry.enabled true # Set a setting value
5kiro-cli settings --delete chat.defaultModel # Delete a setting
6kiro-cli settings open # Open settings file in editor
7kiro-cli settings list --format json-prettySettings file: ~/.kiro/settings/cli.json
Theme
1kiro-cli theme --list # List available themes
2kiro-cli theme dark # Set dark theme
3kiro-cli theme light # Set light theme
4kiro-cli theme system # Follow system preference
5kiro-cli theme --folder # Show theme directory pathInline Suggestions (Ghost Text)
1kiro-cli inline enable # Enable inline suggestions
2kiro-cli inline disable # Disable inline suggestions
3kiro-cli inline status # Show current status
4kiro-cli inline set-customization # Select a customization model
5kiro-cli inline show-customizations # Show available customizations
6kiro-cli inline show-customizations --format jsonIntegrations
1kiro-cli integrations install # Install system integrations
2kiro-cli integrations uninstall # Uninstall integrations
3kiro-cli integrations reinstall # Reinstall integrations
4kiro-cli integrations status # Check integration status
5kiro-cli integrations uninstall --silentDiagnostics & Maintenance
1kiro-cli doctor # Diagnose + fix common issues
2kiro-cli doctor --all # Run all tests (no fixes)
3kiro-cli doctor --strict # Error on warnings
4kiro-cli doctor --format json
5
6kiro-cli diagnostic # Run diagnostic tests
7kiro-cli diagnostic --format json-pretty
8kiro-cli diagnostic --force
9
10kiro-cli update # Update to latest version
11kiro-cli update --non-interactive # Skip confirmation prompt
12
13kiro-cli version # Show version
14kiro-cli version --changelog # Show current version changelog
15kiro-cli version --changelog=all # Show all changelogs
16kiro-cli version --changelog=1.5.0 # Show specific version changelog
17
18kiro-cli issue # Create GitHub issue interactively
19kiro-cli issue "Autocomplete not working" # Create with descriptionLogging
1# Log locations
2# macOS: $TMPDIR/kiro-log/
3# Linux: $XDG_RUNTIME_DIR or /tmp/kiro-log/
4
5# Log levels (KIRO_LOG_LEVEL env var)
6# error (default) | warn | info | debug | trace
7
8export KIRO_LOG_LEVEL=debug
9kiro-cli chat
10
11# Fish shell
12set -x KIRO_LOG_LEVEL debug
13kiro-cli chat⚠️ Logs may contain sensitive data (file paths, code, command output). Be careful when sharing.