<div align="left">
  <img src="assets/kiro-icon.png" alt="Kiro" width="120" height="120">
  
  # Kiro
  
  Kiro is an agentic IDE and command-line interface that helps you go from prototype to production with spec-driven development, agent hooks,powers, and natural language coding assistance. Build faster with AI-powered features that understand your entire codebase, turn prompts into structured specs, and automate repetitive tasks.

  [<img alt="Discord link" src="https://img.shields.io/discord/1374034175430230016?style=flat&logo=discord&logoColor=white&label=discord&color=%239046ff" />](https://discord.gg/kirodotdev)
</div>

## Core Capabilities

- **Specs** - Plan and build features using structured specifications that break down requirements into detailed implementation plans
- **Hooks** - Automate repetitive tasks with intelligent triggers that respond to file changes and development events
- **Agentic Chat** - Build features through natural conversation with Kiro that understands your project context
- **Steering** - Guide Kiro's behavior with custom rules and project-specific context through markdown files
- **MCP Servers** - Connect external tools and data sources through the Model Context Protocol
- **Powers** -  Specialized context and tools for Kiro agents on-demand. Extend agent capabilities with domain-specific knowledge and custom integrations
- **Privacy First** - Keep your code secure with enterprise-grade security and privacy

## Available Interfaces

Kiro is available as both a desktop application and command-line tool:

### Kiro IDE (Desktop Application)
The standalone desktop application is available for:
- macOS
- Windows
- Linux

### Kiro CLI
Command-line interface for integrating Kiro into your development workflows and automation scripts.

For detailed information on both interfaces, visit [kiro.dev](https://kiro.dev)

## Getting Started

### Download & Install

**IDE:** Download the Kiro desktop application directly from [kiro.dev](https://kiro.dev)

**CLI:** Instructions for installing the Kiro CLI are available in our [documentation](https://kiro.dev/cli)

### First Project

Get started with Kiro by following our comprehensive **[first project guide](https://kiro.dev/docs/getting-started/first-project/)**. This hands-on tutorial walks you through Kiro's essential features.

**What you'll learn:**
- Setting up steering files for project-specific guidance
- Creating and managing specs for structured development
- Configuring hooks to automate your workflow
- Connecting MCP servers for external integrations


### One-Click Migration
Import your VS Code setup including extensions and settings during the initial setup process.

## Documentation

**[📚 View Documentation →](https://kiro.dev/docs/)**

- [Getting Started](https://kiro.dev/docs/getting-started) - Installation and first project setup for IDE and CLI
- [IDE Guide](https://kiro.dev/docs/) - Desktop application features and workflows
- [CLI Guide](https://kiro.dev/docs/cli) - Command-line interface usage and automation

## Issue Reporting
We welcome feedback and issue reports to help improve Kiro. Please use this repository to:
- Report bugs and technical issues
- Request new features
- Share feedback on existing functionality
- Discuss improvements and enhancements

## Support
For additional support beyond issue reporting:
- Join our community [discord server](https://discord.gg/kirodotdev) for quick help and discussions with other developers
- For billing-related questions, please contact our support team through [AWS Billing Support](https://support.aws.amazon.com/#/contacts/kiro).
- If you are an existing AWS customer with a [paid support plan](https://aws.amazon.com/premiumsupport/plans/), for technical issues or general assistance, reach out via [AWS Support](https://support.console.aws.amazon.com/support/home#/).

## Security
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/). Please do **not** create a public github issue.

## Code of Conduct
This project has adopted the [Amazon Open Source Code of Conduct](https://aws.github.io/code-of-conduct).
For more information see the [Code of Conduct FAQ](https://aws.github.io/code-of-conduct-faq) or contact
opensource-codeofconduct@amazon.com with any additional questions or comments.


---
©2026 Amazon.com, Inc. or its affiliates (collectively, "Amazon"). All Rights Reserved.
