Installation - Get Started - Docs - Kiro Loading image... Product * About Kiro * IDE * CLI * Web * Mobile * Crew * Pricing * Downloads For * Enterprise * Startups * Students Community * Overview * Ambassadors * Discord * Events * Powers * Shop * Showcase Resources * Docs * Blog * Changelog * FAQs * Report a bug * Suggest an idea * Billing support Social * * * * * * * English Site Terms License Responsible AI Policy Legal Privacy Policy Cookie Preferences English Loading image... * Apps * CLI * Web * Enterprise * Pricing * Docs * Community * Resources SIGN IN DOWNLOADS Loading image... Get Started Installation Authentication Your first project Models Overview Available models Reasoning effort Features How Kiro works Specs Steering Hooks MCP Permissions Custom agents Agent Skills Powers Cloud sessions Compaction Kiroignore Checkpoints and rewind Built-in tools Configuration scopes IDE 1.x What's new in 1.0 Setup & First Run Editor Chat Experimental Troubleshooting 0.x reference CLI What's new in 3.0 Setup & First Run Terminal UI Chat Voice mode Headless mode ACP Auto complete Experimental 2.x reference Crew Quick start Installation Running 24/7 Chat Agent Capabilities Features Interfaces Apps System & storage Configuration Security Troubleshooting Web Setup & First Run Identity Center Connect your repositories Working with the agent Autonomous mode Automations Memory Configuration Sync Sandbox Mobile - Preview Overview Commands and Reference CLI commands Slash commands Built-in tools Exit codes Settings Billing Overview Managing your subscription Upgrading your plan Downgrading your plan Cancelling your plan Purchasing add-on credits Managing your payments Managing usage notifications Managing your taxes Contacting billing support Deleting your account Related questions Enterprise Concepts Onboarding quickstart Connecting your identity provider Deployment options Subscribe your team Manage subscriptions Governance Monitor and track Settings Managed updates Billing IAM Supported regions Privacy and Security Overview Data protection Code references Compliance validation Infrastructure security IAM permissions Firewalls, proxies, and data perimeters VPC endpoints (AWS PrivateLink) Guides Overview Language support Learn by playing Migration Migrating from Q Developer Migrating from VSCode Upgrading from Q CLI * Docs * * Get Started * * Installation Copy page View as Markdown Installation Copy page View as Markdown Kiro is available as a desktop IDE, a command-line interface, a web app, a mobile app, and a personal AI agent (Crew). Pick the surface that fits your workflow. You can use more than one, and your .kiro configuration is shared across all of them. System requirements IDE - macOS (Intel + Apple Silicon), Windows 10/11 (64-bit), or Linux (Ubuntu 24+, Debian 13+, Fedora 40+, Arch, Mint 22+). CLI - macOS, Windows 11 (PowerShell), or Linux (glibc 2.34+ or musl variant). Web - Any modern browser. No local installation required. Mobile - iOS, distributed through Apple TestFlight during early access. Crew - macOS, Linux (x86_64 and ARM), or Windows. Python 3.9+ required for source installs. Install Kiro IDE CLI Web Mobile Crew 1 Download Kiro Go to kiro.dev and download the installer for your operating system (macOS, Windows, or Linux). 2 Run the installer Open the downloaded file and follow the installation instructions for your platform. 3 Sign in When you open Kiro for the first time, sign in with a provider of your choice (Google, GitHub, AWS Builder ID, or organization identity). Learn more about authentication . 4 Import settings (optional) You can import your VS Code settings and extensions . If you use another editor, skip this step and select your preferred theme. 5 Open a project From the welcome page, open a folder to start your first session. See Your first project for a guided walkthrough. Upgrading IDE CLI Web Kiro IDE downloads updates automatically in the background. When an update is ready, you'll see a notification to restart and apply it. To check manually, open the Kiro menu and select Check for Updates... On Windows or Linux, open the Command Palette ( Ctrl + Shift + P ) and run Kiro: Check for Updates . Downgrade to a previous version IDE CLI You can revert to an earlier version of Kiro IDE if an update introduces issues with your workflow. * Go to the downloads page * Scroll past the main download cards to the version list * Expand the version you want to install (for example, "IDE 0.12.x") * Download the installer for your platform * Uninstall your current version of Kiro: * macOS: drag Kiro from Applications to the Trash * Windows: uninstall from Settings > Apps > Installed apps * Linux: run sudo apt remove kiro or sudo dnf remove kiro depending on your package manager * Run the downloaded installer Your settings, extensions, and sign-in state are preserved across reinstalls. When you're ready to move back to the latest version, download it from the downloads page or let the application update automatically. Uninstalling IDE CLI Uninstall Kiro IDE using your operating system's standard application removal process (drag to Trash on macOS, Apps & Features on Windows, or your package manager on Linux). Proxy configuration Kiro respects standard proxy environment variables ( HTTP_PROXY , HTTPS_PROXY , NO_PROXY ) on both the IDE and the CLI. Set these in your shell: bash export HTTP_PROXY = http://proxy.company.com:8080 export HTTPS_PROXY = http://proxy.company.com:8080 export NO_PROXY = localhost,127.0.0.1,.company.com For proxies that require authentication: bash export HTTPS_PROXY = http://username:[email protected]:8080 IDE CLI In addition to the environment variables, you can configure proxy settings in Settings > Proxy inside Kiro. Browser-based sign-in bypasses proxy settings When you sign in, Kiro opens your default browser. This browser traffic uses your operating system's network stack, not the IDE's proxy configuration. For the full reference, including URLs to allowlist and data perimeter guidance, see Firewalls, proxies, and data perimeters . Troubleshooting IDE CLI For installation failures, network connectivity problems, sign-in errors, shell integration, and Windows-specific issues, see the IDE troubleshooting guide . Next steps * Authentication — set up your sign-in method * Your first project — guided walkthrough for new users * Language support — environment setup per language Page updated: September 2, 2026 Authentication