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. First Task

Your first task


Now that you've set up Kiro Web (Preview), let's create your first task.

Start a new session

  1. Go to app.kiro.dev
  2. Optionally select repositories using Select repo before starting your task

Describe your task

Write a clear description of what you want the agent to do. For your first task, try something straightforward like:

  • "Add error handling to the login function in auth.ts"
  • "Write unit tests for the UserService class"
  • "Update the README with installation instructions"

Or try something that spans multiple repositories:

  • "Add a new API endpoint in the backend service and update the frontend client to call it"
  • "Update the shared authentication library and migrate both the web and mobile apps to use the new version"

Include any specific requirements or constraints in your description. You can always refine or add more details as the conversation progresses.

Select repositories

If you didn't select repositories when starting the session, you'll be prompted to choose them when you ask the agent to work on something. Only select repositories you trust, especially when mixing public and private repos, as the agent learns from and follows instructions in the repository code even if those instructions are malicious.

What happens next

How the agent proceeds depends on the mode you're using:

Default mode — The agent works with you interactively. It analyzes your request, discusses the approach, and you iterate together. When you're satisfied, ask the agent to open a pull request.

Autonomous mode — Toggle Autonomous on in the chat input bar. The agent asks clarifying questions, builds a plan, executes the work with specialized sub-agents, and opens pull requests automatically.

Review the pull request

When the agent opens a pull request:

  1. Check the code changes and implementation approach
  2. Leave comments with feedback or suggestions
  3. The agent automatically addresses your comments and pushes updates

Comments like "always use our standard error handling" or "remember to follow our naming conventions" help the agent learn your team's patterns for future work.

Next steps

  • Learn more about working with the agent
  • Try autonomous mode for end-to-end task execution
  • Configure the sandbox
  • Set up steering files to guide the agent
Page updated: April 21, 2026
Setup
AWS Identity Center