Sticky disks

The blacksmith stickydisk commands let you inspect and delete a repository’s sticky disks programmatically.

Permissions

Listing requires the user who created the CLI token to be able to see the target repository on GitHub (any permission level, including read) — the same visibility rule the dashboard enforces. For org-scoped sticky disks (such as container caching), access to any repository in the organization suffices for listing. Deleting additionally requires the user who created the CLI token (via blacksmith auth login) to have write access to the target repository on GitHub (the WRITE, MAINTAIN, or ADMIN role) — the same rule the dashboard enforces. For org-scoped sticky disks (such as container caching), write access to any repository in the organization suffices. Tokens not tied to a user account cannot delete; re-authenticate with blacksmith auth login to mint a token tied to your account. Organization tokens are exempt from these per-repository checks and can list and delete for any repository in the organization.

`blacksmith stickydisk list`

Lists sticky disks for a repository.

blacksmith stickydisk list --repo my-org/my-repo --format table

KEY                              TYPE      SIZE_MB  ARCH   REGION    LAST_USED_AT
my-org/my-repo                   dockerfile 8192.0  amd64  us-east-1 2026-08-19T18:02:11Z
my-org/my-repo-bazel-cache       stickydisk 4096.0  arm64  us-east-1 2026-08-19T14:40:03Z

Flag	Description
`--repo`	Repository (owner/name or bare name). Required.
`--search`	Filter to sticky disk keys containing this substring.
`--sort-by`	Sort column: `key`, `type`, `size`, `last_used_at`, `arch`, `region`. Defaults to `last_used_at`.
`--sort-direction`	`asc` or `desc`. Defaults to `desc`.
`--page`, `--per-page`	Pagination (per-page 1-100, default 50).
`--format`	`json`, `table`, or `yaml`. Defaults to `json`.

`blacksmith stickydisk delete`

Deletes all sticky disks for a repository that exactly match --key. By default every architecture variant of the key is deleted; narrow the selection with --arch.

blacksmith stickydisk delete --repo my-org/my-repo --key my-org/my-repo-bazel-cache

Flag	Description
`--repo`	Repository (owner/name or bare name). Required.
`--key`	Exact sticky disk key to delete. Required.
`--arch`	Restrict deletion to one architecture (e.g. `amd64`, `arm64`).
`--yes`	Skip the confirmation prompt.

Deleting a sticky disk is safe: the next job that requests the key starts from an empty disk and repopulates it, the same as a cold cache.

Getting Started

Performance

Testboxes

CLI

Observability

Administration

Support and Terms

Permissions

`blacksmith stickydisk list`

`blacksmith stickydisk delete`

​Permissions

​blacksmith stickydisk list

​blacksmith stickydisk delete

Permissions

`blacksmith stickydisk list`

`blacksmith stickydisk delete`