Skip to main content
An agent is a kiro-cli session working in a checkout of your project, on the laptop of the developer who started it. Agents are keyed by ticket.

Ticket start and branch start

  • Ticket start. The agent gets the Asana task as its brief, starts implementing, and the ticket moves to In progress. The work branch is the ticket key.
  • Branch start. There is no written requirement. The agent reads the branch, says what it appears to be for, and waits for you.
Prefer a ticket start whenever the work has a ticket.

States you will see

The agents grid shows each agent as one of: laptop online or offline, waiting_for_runner, launching, running, or blocked on a question. It also shows the repo checkout, credits spent and the pull request. An agent runs only while your runner is connected. If the runner is offline when you start an agent, it waits and launches when the laptop reconnects.

Lifecycle

The workspace lives at ~/code-it/<project-slug>/<ticket>.