# Kiro

Use Kiro with Buddy to deploy your project, trigger and monitor pipelines, and debug builds from your IDE.

Kiro is AWS's agentic IDE built around spec-driven development. It works with the full context of your project - turning requirements into specs, reading across the codebase, running commands, and editing files wherever changes are needed. Paired with Buddy, Kiro can deploy your project and let Buddy handle the entire deployment workflow. On top of that, it can trigger and monitor your pipelines, ship changes across environments, and dig through build output and logs when something needs fixing.

<Hint type="info">
This page covers working with Buddy from within Kiro. On top of that, you can run AI coding agents in a fully isolated Buddy sandbox - see [Run agents in a sandbox](/docs/ai-agents/sandboxes.md).
</Hint>

## Quick start

<Steps>
  <Step title="Install the Buddy CLI">
    ```bash
    npm install -g bdy
    ```
  </Step>
  <Step title="Log in to Buddy">
    ```bash
    bdy login
    ```
  </Step>
  <Step title="Link your project">
    Run this inside your project directory to connect it to a Buddy project:

    ```bash
    bdy proj link
    ```
  </Step>
  <Step title="Install the Buddy skill">
    ```bash
    npx skills add buddy/buddy-plugin
    ```
  </Step>
  <Step title="Open your project in Kiro">
    Open the project directory in Kiro and start the agent from the chat panel.
  </Step>
  <Step title="Prompt the agent">
    Ask it to build and ship something end to end, for example:

    ```text
    Create a snake app and deploy it for me
    ```
  </Step>
</Steps>

## Example prompts

Once the agent is running and your project is linked to Buddy, try prompts like:

- Create a Next.js app and deploy it to production.
- Deploy an Umami analytics instance and wire it into my app.
- Deploy an AI chatbot with Postgres for history and Redis for rate limiting.
- Deploy my app, set up a CDN, and buy and configure a domain with SSL.
- Add a pipeline that runs on every change in the repository and executes my test suite.
- Add a pipeline that runs every minute, checks that my site is up, and sends a notification to Slack, email, Telegram, or SMS if anything is wrong.
- Check the last few CI pipeline runs for failures, read the logs, and fix the failing tests.
- Analyze the logs from the last production deployment and fix the errors.
- Find the last successful production deployment and roll back to it.
- Check my app logs and open issues based on what you find.

## Connect MCP

Give Kiro access to Buddy over MCP so it can run pipelines, manage deployments, and read logs. See the [MCP](/docs/ai-agents/mcp.md) page for the regional server URLs and how to filter the exposed tool categories.

Add the server to `.kiro/settings/mcp.json` in your workspace (or `~/.kiro/settings/mcp.json` for all workspaces):

```json
{
  "mcpServers": {
    "buddy": {
      "url": "https://mcp.buddy.works/mcp"
    }
  }
}
```

Or ask Kiro to set it up for you:

```text
Add the Buddy MCP server (https://mcp.buddy.works/mcp) to your MCP configuration.
```


---
Original source: https://buddy.works/docs/ai-agents/agents/kiro