Setup

Get started with Kiro Web (Preview) by signing in and connecting your GitHub account. Setup steps differ depending on whether you use social login or AWS Identity Center.

1. Navigate to app.kiro.dev and sign in with your AWS Builder ID
2. Ensure you have a paid Kiro subscription (Pro or higher). Kiro Web is not available on the free tier.
3. Connect GitHub to give the agent access to your repositories

1. Your administrator must enable the Kiro Web agent for your organization
2. Sign in at app.kiro.dev using your Identity Center credentials
3. Kiro Web requires a Kiro Profile — it does not work with Q Developer Profiles
4. Connect GitHub to give the agent access to your repositories

See the AWS Identity Center guide for details on shared settings and limitations.

Connect your GitHub account to give the agent access to your repositories:

1. Go to Settings and select the Agent tab
2. Under GitHub, click Connect GitHub
3. Authorize the Kiro Agent GitHub app
4. Select which repositories the agent can access

You must have write permissions on repositories for the agent to create branches and open pull requests.

How repository access works: Kiro Web shows all repositories where both conditions are met:

1. Your GitHub user has access to the repository
2. The Kiro Agent GitHub app has been installed and authorized for that repository

This means you'll see repositories from personal accounts, shared repositories, and organizations — as long as both your GitHub user and the Kiro Agent app have access.

See the GitHub integration guide for detailed setup instructions.

Once you've connected your GitHub account, you're ready to start working with the agent.