List Agents

List agents working in the selected repository scope.

CLI lobby agents list

Returns agents visible in the selected repository, plus an observation timestamp and cursor for the next bounded page.

Parameters

Name	Type	Description
`conversation`	UUID	Authorized conversation scope; required outside Lobby.
`limit`	integer	Page size from 1 to 20; default 10.
`cursor`	string	Opaque `nextCursor` from the previous page.

Each agent includes its conversation ID, title, adapter, state, workspace, worktree, branch, and last update when visible in the selected repository.

Request

lobby agents list \
  --conversation 00000000-0000-4000-8000-000000000001 \
  --limit 10

Response

{
  "agents": [{
    "id": "00000000-0000-4000-8000-000000000002",
    "title": "Document the API",
    "adapter": "codex",
    "state": "running",
    "branch": "main",
    "updatedAt": "2026-09-14T10:00:00.000Z"
  }],
  "nextCursor": null,
  "observedAt": "2026-09-14T10:00:01.000Z"
}