Installation

You can install Kiro CLI on Windows 11 using PowerShell. Open Windows Terminal (or any PowerShell terminal) and run:

Kiro will direct you to open your web browser, where you will follow the steps under Authentication.

Kiro CLI auto-updates in the background. When a new version is available, it downloads silently and installs when you exit the application.

To disable auto-update:

kiro-cli settings "app.disableAutoupdates" "true"

Uninstall Kiro CLI through Windows Settings > Apps, or run:

kiro-cli uninstall

Kiro CLI (v1.8.0 and later) supports proxy servers commonly used in enterprise environments. The CLI automatically respects standard proxy environment variables.

Configure proxy settings by setting these environment variables in your shell:

# HTTP proxy for non-SSL traffic
export HTTP_PROXY=http://proxy.company.com:8080

# HTTPS proxy for SSL traffic  
export HTTPS_PROXY=http://proxy.company.com:8080

# Bypass proxy for specific domains
export NO_PROXY=localhost,127.0.0.1,.company.com

For proxies requiring authentication:

export HTTP_PROXY=http://username:password@proxy.company.com:8080
export HTTPS_PROXY=http://username:password@proxy.company.com:8080

If you encounter proxy-related connection issues:

• Verify proxy server accessibility and credentials
• Ensure your corporate firewall allows connections to AWS endpoints
• Contact your IT administrator if SSL certificate validation fails
• Check that the proxy server supports the required protocols

You can uninstall Kiro CLI if you no longer need it.

To uninstall Kiro CLI on macOS, run:

kiro-cli uninstall

To uninstall Kiro CLI on Ubuntu, complete the following procedure.

1. Use the apt package manager to remove the package:

   bash

   sudo apt-get remove kiro-cli
   

2. Remove any remaining configuration files:

   bash

   sudo apt-get purge kiro-cli
   

If you're having a problem with Kiro CLI, run kiro-cli doctor to identify and fix common issues.

Kiro CLI writes logs to platform-specific locations:

Override the log path with the KIRO_CHAT_LOG_FILE environment variable:

KIRO_CHAT_LOG_FILE=/tmp/my-debug.log kiro-cli chat

On Windows (PowerShell):

$env:KIRO_CHAT_LOG_FILE = "C:\temp\my-debug.log"
kiro-cli chat

$ kiro-cli doctor

✔ Everything looks good!

Kiro CLI still not working? Run kiro-cli issue to let us know!

If your output doesn't look like the expected output, follow the prompts to resolve your issue. If it's still not working, use kiro-cli issue to report the bug.

Here are some common issues you might encounter when using Kiro CLI:

Authentication failures : If you're having trouble authenticating, try running kiro-cli login to re-authenticate.

Autocomplete not working : Ensure your shell integration is properly installed by running kiro-cli doctor.

SSH integration issues : Verify that your SSH server is properly configured to accept the required environment variables.

Follow these steps to troubleshoot issues with Kiro CLI:

1. Run kiro-cli doctor to identify and fix common issues.
2. Check your internet connection.
3. Verify that you're using a supported environment. For more information, see Supported command line environments.
4. Try reinstalling Kiro CLI.
5. If the issue persists, report it using kiro-cli issue.