Setup

Get started with Kiro Web (Preview) by signing in and connecting a repository provider. Kiro Web works with both GitHub and GitLab. 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 a repository provider — GitHub or GitLab — 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 a repository provider — GitHub or GitLab — 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.

Kiro Web connects to GitLab using a personal access token (PAT):

1. In GitLab, select your avatar and choose Preferences, then go to Access > Personal access tokens and select Generate token
2. Select a scope, then create the token and copy it. The api scope gives Kiro full access; see the GitLab integration guide if you want to scope the token down
3. In Kiro, go to Settings and select the Agent tab
4. Under GitLab, click Connect GitLab
5. Paste your personal access token and select the GitLab instance (gitlab.com is populated by default)

Once connected, your GitLab projects are available to select when you create a session or add a repository mid-session.

See the GitLab integration guide for detailed setup instructions.

Once you've connected a repository provider, you're ready to start working with the agent.