Fleet docs v0.2.0-rc.448

Workers

The page no longer draws this list (#316): Home shows your sessions with their workers, and the Agent graph shows every agent. The workers section of /api/state is unchanged, and both read it.

One row for each agent, and for admins, each Claude Code session on each box. The row shows the health, the name, the project and what the agent does now. Buttons let you answer, send a message or stop.

How to read it

  • The badges at the top count the rows of each health.
  • Each row: a health badge, the name, then project · kind · model · state · "active … ago" · trace id. Under it, the line "doing": the last report, or the reason why it waits.
  • The health is the state of the agent, with one change: a working agent with no turn that runs shows as idle. retrying shows its count, for example "retrying 2/3".
  • Sessions that fleet did not start have their own health: parked (a background session with no process), stuck (busy, no transcript change for 30 minutes), working, done, idle.
  • Buttons, if you have the right: Answer for an agent in needs_input, Message to send a message, Stop to stop it. A session that fleet did not start has no buttons.

When it looks wrong

The doing line says It means Do this
"profile … is paused: no usable login…" The profile cannot sign in fleet profile rotate <name> with a new token
"profile … is at its usage limit (five_hour 100%) until T…" The profile hit a usage limit; fleet profile ls shows it limited Wait until T, or fleet agent profile <agent> <profile>
"profile … is paused until …" Someone paused the profile Wait, or move the agent with fleet agent profile
"waiting for node … to claim it" The agent can run only on that node, and the node did not claim Check that the node is up. See This box.
"queued: no node takes K agents…" No node lists this kind in kinds Add the kind to a node, or spawn with another --kind
"usage limit until …" The profile is at its limit Wait, or see a usage limit
"held: … turns in a row made no progress" The agent is held Read its transcript. Resume it through the control MCP or the API.
"turn ended without done: …" It waits for a message Send a message, or Answer
" refused: HTTP 403" after a button You do not have that right on this agent Ask its owner

Rows: live agents first, then the newest. With box sessions, the order is by health (stuck, blocked, idle, working, done, parked), then project, then name. Code: fleet/internal/api/state.go, fleet/internal/dash/workers.go.