A Grain of Salt

Kiro CLI Cheatsheet: CLI Commands

· Teddy Aryono

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

FlagShortDescription
--verbose-vIncrease log verbosity (repeat: -vv, -vvv)
--agent <name>Start session with a specific agent
--help-hShow help
--version-VShow version
--help-allPrint 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 output

Chat

 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/auto

Translate (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 agents

Agent config locations:


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-server

Settings

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-pretty

Settings 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 path

Inline 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 json

Integrations

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 --silent

Diagnostics & 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 description

Logging

 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.

#kiro

Reply to this post by email ↪