circleci runner fleet list and get
Introduced 2026-10-08 · score 0.93
HOW TO USE IT
To inspect agents for a runner resource class, run `circleci runner fleet get <namespace>/<resource-class>`; use `fleet list` to browse fleets, optionally filtering by organization, namespace, or resource class.
circleci runner fleet list [--org <slug-or-uuid> | --namespace <namespace> | --resource-class <namespace/name-or-id>] [--json] [--jq <jq-expression>]circleci runner fleet get <namespace>/<resource-class> [--json] [--jq <jq-expression>]circleci runner instance list --resource-class <namespace>/<resource-class>WHY THIS HELPS
Inspect agents attached to a CircleCI runner resource class and check its task counts.
REQUIREMENTS AND LIMITATIONS
- Version: v1.4.0
- <resource-class> (required): Resource class as `namespace/name` or its ID; identifies the fleet for `get`.
- --org <slug-or-uuid>: Filter `list` by organization slug or UUID; defaults to the organization from the git remote.
- --namespace <namespace>: Filter `list` by resource class namespace. Use only one list filter at a time.
- --resource-class <namespace/name-or-id>: Filter `list` by one resource class name or ID. Use only one list filter at a time.
- --json: Output JSON.
- --jq <jq-expression>: Process response values using jq syntax.
- Prerequisite: Install and authenticate the CircleCI CLI; fleet commands use the experimental API.
- A fleet is the set of agents attached to one resource class and shares that resource class's ID.
- With no filter, `list` uses the org from the git remote.
- `list` follows the cursor with `page[limit]=250`.
- Only the single-fleet `get` endpoint returns running and queued task counts.
- When `agent_count` exceeds the server's capped agent list, the output indicates truncation and points to `runner instance list`.
- Docs conflict: The v1.4.0 release note says running and queued task counts are returned only by `fleet get`. Current CircleCI documentation says `fleet list` also returns these counts. The current documentation describes behavior different from the stated release; no list task-count behavior is included here.
FIRST-PARTY EVIDENCE
- https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.4.0
- https://github.com/CircleCI-Public/circleci-cli/pull/1893
- https://cli.circleci.com/reference/
- https://circleci.com/docs/runner/monitor-runner-fleets/
Check the installed version and the source before using it. Entry JSON