> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiml-code-it.automat-it.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> One Kiro agent per ticket or branch, running on a laptop.

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

| Action | Effect |
| - | - |
| Stop | Stops the agent. Its workspace and work survive. |
| Start | Resumes a stopped agent on your laptop. |
| Terminate | Ends the agent and releases its workspace. Irreversible. |

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.