Loading image...Kiro
  • CLI
  • Web
  • Powers
  • Enterprise
  • Pricing
  • Docs
SIGN INDOWNLOADS
Loading image...Kiro
Loading image...Kiro
Product
  • About Kiro
  • CLI
  • Web
  • Powers
  • Pricing
  • Downloads
For
  • Enterprise
  • Startups
  • Students
Community
  • Overview
  • Showcase
  • Discord
  • Events
Resources
  • Documentation
  • Blog
  • Changelog
  • FAQs
  • Report a bug
  • Suggest an idea
  • Billing support
Social
Site TermsLicenseResponsible AI PolicyLegalPrivacy PolicyCookie Preferences
  1. Docs
  2. Web
  3. Using The Agent

Working with the agent


Kiro Web's (Preview) default mode is collaborative — you work with the agent interactively, iterating on a problem together. The agent helps you think through approaches, write code, and open pull requests when you're ready.

For tasks where you want the agent to own the outcome end-to-end, see autonomous mode.

Start a session

  1. Go to app.kiro.dev and click New session
  2. Select one or more repositories using Select repo at the bottom of the chat input
  3. Describe what you want to work on

If you don't select repositories upfront, you'll be prompted to choose them when you ask the agent to work on something.

Warning

Only select repositories you trust, especially when mixing public and private repos. The agent learns from and follows instructions in the repository code, even if those instructions are malicious.

How it works

In the default mode, you drive the conversation. Chat with the agent to:

  • Discuss implementation approaches and trade-offs
  • Ask questions about your codebase
  • Get the agent to write or modify code
  • Iterate on the implementation with feedback
  • Ask the agent to open a pull request when you're satisfied

The agent has access to web search, context from your repositories, and learnings from previous code reviews to provide informed responses.

Opening a pull request

When you're happy with the changes, ask the agent to open a pull request. The agent creates a feature branch, commits the changes, and opens a PR with a description of what was done.

You can continue to provide feedback on the PR. The agent responds to your comments and pushes updates.

Selecting repositories

You can work across multiple repositories in a single session. When you select repos, the agent clones them into its sandbox and can coordinate changes across all of them.

Chat and session behavior

Each session has a single conversation thread. You can:

  • Steer the agent on implementation approach at any time
  • Provide additional requirements or constraints
  • Ask the agent to do more work after reviewing results

To work on a different topic, start a new session.

Data retention

Sessions expire after 90 days, at which point chat messages and logs are deleted. Pull requests, code changes, and conversations on GitHub are not affected.

Web search

Kiro Web can search the web to access current information in real-time, enabling up-to-date answers about topics that may have changed since the model's training data was created.

Web search is designed to not reproduce meaningful chunks of text and cannot access pages behind paywalls or authentication. Web searches are logged in the session with citations, so you can see what sources the agent referenced.

Learn more

Creating tasks
Create tasks from the web app or directly from GitHub issues
Chatting with the agent
Discuss approaches and provide guidance
Page updated: April 21, 2026
AWS Identity Center
Chatting with the agent