---
next_cursor: eyJzY29yZSI6MCwic2VxIjoxOTgzLCJzaW5jZSI6bnVsbCwidG9vbCI6ImNpcmNsZWNpIiwidiI6MX0
has_more: false
next: https://sincecutoff.com/v1/changes.md?tool=circleci&score=0&cursor=eyJzY29yZSI6MCwic2VxIjoxOTgzLCJzaW5jZSI6bnVsbCwidG9vbCI6ImNpcmNsZWNpIiwidiI6MX0
items: 5
---
# sincecutoff.com changes: circleci

## circleci adds resource-usage command with charts (circleci, 2026-08-13)
Published 2026-10-19
- slug: circleci-adds-resource-usage-command-with-charts-d65a8602f276
- score: 0.92

How to use it:

When reviewing a repository’s CI configuration, inspect a job’s CPU and memory use against its resource class limits with `circleci job resource-usage get <job-id>`.

Examples:

```
circleci job resource-usage get <job-id>
```

- why_it_matters: Inspect CircleCI resource usage while maintaining a repository's CI configuration.
- sources: <https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.0.48122>, <https://cli.circleci.com/reference/>
- gotchas: "Version: v1.0.48122"; "<job-id> (required): UUID of the job whose resource usage to fetch; find job IDs in `circleci workflow get` or `circleci job get`."; "--chart string: Choose parallel execution chart layout: auto, combined, or separate; default is auto."; "--execution int: Select a parallel execution index; default is all executions."; "--jq string: Process response values using jq syntax."; "--json: Output response as JSON."

## circleci deploy rollback (circleci, 2026-08-17)
Published 2026-10-19
- slug: circleci-deploy-rollback-9feea2d3f9cf
- score: 0.97

How to use it:

When a CircleCI-managed deployment needs reverting, run `circleci deploy rollback` with the target version, component, and environment; provide the current version with `--from` if you need to assert which deployment is being replaced.

Examples:

```
circleci deploy rollback <target-version> --component <component> --environment <environment>
```

```
circleci deploy rollback <target-version> --component <component> --environment <environment> --from <current-version> --force
```

```
circleci deploy rollback <target-version> --component <component> --environment <environment> --reason "<reason>" --param <key>=<value>
```

- why_it_matters: Roll back a deployment managed through CircleCI.
- sources: <https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.0.48275>, <https://cli.circleci.com/reference/>, <https://circleci.com/docs/guides/deploy/rollback-a-deployment/>
- gotchas: "Version: v1.0.48275"; "<target-version> (required): Version to roll back to."; "--component (required): Deploy component name or ID."; "--environment (required): Deploy environment name or ID."; "--from: Version being replaced; defaults to the latest deployed version."; "--force / -f: Skip the confirmation prompt."; "--namespace: Namespace scoping the component; defaults to `default`."; "--param: Rollback pipeline parameter in `key=value` form; repeatable."; "--reason: Reason for the rollback, recorded in the audit log."; "--project: Project slug; defaults to the current Git remote."; "--checkout-ref: Git ref the rollback pipeline checks out."; "--config-ref: Git ref from which the rollback pipeline config is read."; "Prerequisite: Install the CircleCI CLI."; "Prerequisite: For rollback through a rollback pipeline, configure deploy markers and a rollback pipeline for the project."

## circleci deploy list adds --org-wide and --limit flags (circleci, 2026-09-21)
Published 2026-10-19
- slug: circleci-deploy-list-adds-org-wide-and-limit-flags-fde651f96a91
- score: 0.92

How to use it:

To list deployments across an organization, run `circleci deploy list --org-wide`; add `--limit <number>` to cap results (default 10, or 0 for all).

Examples:

```
circleci deploy list --org-wide --limit 50
```

```
circleci deploy list --org-wide --project gh/<org>/<repo>
```

- why_it_matters: List deployments across an organization or limit the number of deployments returned.
- sources: <https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.0.50849>, <https://cli.circleci.com/reference/>
- gotchas: "Version: v1.0.50849"; "--org-wide: Lists deployments across all projects in the organization."; "--limit <int>: Maximum number of deployments to return; default 10, and 0 means all."; "--project <slug>: Project slug (for example, `gh/myorg/myrepo`); defaults to the current Git remote. Can provide the organization context for org-wide listing."; "Prerequisite: The CLI infers the project from the current Git remote unless `--project` is provided. The reference does not state an auth scope or minimum CLI version for this command."

## circleci runner fleet list and get (circleci, 2026-10-08)
Published 2026-10-19
- slug: circleci-runner-fleet-list-and-get-c4ebaa4a8267
- 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.

Examples:

```
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_it_matters: Inspect agents attached to a CircleCI runner resource class and check its task counts.
- sources: <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/>
- gotchas: "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."

## circleci function list filters pseudo-versions unless requested (circleci, 2026-10-15)
Published 2026-10-19
- slug: circleci-function-list-filters-pseudo-versions-unless-requested-6d92bf1f8661
- score: 0.94

How to use it:

When inspecting untagged function builds, run `circleci function list --include-pseudo` to include pseudo-versions in each function’s versions. To select or pin one by version, use `--version` or `function add`/`function update` without `--include-pseudo`.[^1][^2]

Examples:

```
circleci function list --include-pseudo
```

```
circleci function list --include-pseudo --json --jq '.[].versions'
```

- why_it_matters: When listing function versions and you need to inspect untagged builds, include pseudo-versions in the list.
- before: Before this change, `circleci function list` included pseudo-versions without requiring a flag.
- sources: <https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.6.0>, <https://github.com/CircleCI-Public/circleci-cli/pull/1906>, <https://github.com/CircleCI-Public/circleci-cli/blob/v1.6.0/internal/cmd/function/list.go>, <https://github.com/CircleCI-Public/circleci-cli>
- gotchas: "Version: v1.6.0"; "--include-pseudo: Include pseudo-versions (untagged builds) in each function’s versions; defaults to false."; "--version: Version selector mentioned in the release note; the note says pseudo-versions can be selected without `--include-pseudo`. Its flag syntax and requiredness were not documented on the official page read."; "Prerequisite: Use CircleCI CLI v1.6.0 or later for the documented `--include-pseudo` flag."; "Prerequisite: The CLI README says to log in with `circleci auth login`."; "Pseudo-versions are untagged builds."; "Pseudo-versions are omitted from version listings unless requested."; "A pseudo-version named with `--version`, or pinned by `function add` and `function update`, is found without `--include-pseudo`."

Next: https://sincecutoff.com/v1/changes.md?tool=circleci&score=0&cursor=eyJzY29yZSI6MCwic2VxIjoxOTgzLCJzaW5jZSI6bnVsbCwidG9vbCI6ImNpcmNsZWNpIiwidiI6MX0
Save `next_cursor`; next visit, pass it to get only what was published since.
<!-- end of page -->