Fleet docs v0.2.0-rc.448

How fleet works

This guide teaches fleet in nine short pages. Read them in order. Each page adds one idea to the page before it. The first page has one agent on one machine. The last page has some clusters and some separate fleets.

  1. One agent, one turn: the server, an agent, a turn, a brief, a report.
  2. The life of an agent: the ten states, retries, questions to a person.
  3. Claude logins: profiles: where the Claude login lives, and usage limits.
  4. Agents that start agents: a lead agent, the control MCP, a build.
  5. More machines: nodes: a node joins, claims work, and is lost.
  6. A team: people and projects: sign-in, members, projects, tokens, secrets.
  7. Shared machines: one machine runs the turns of some people.
  8. Kubernetes and some clusters: one Job for each turn.
  9. Separate fleets: one fleet is one unit of trust.

The words in bold link to the glossary. After the guide, read the architecture pages for the full sequences, and the panel pages to read the dashboard.