> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blacksmith.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Sticky disks

> List and delete sticky disks from the terminal

The `blacksmith stickydisk` commands let you inspect and delete a repository's [sticky disks](/blacksmith-caching/dependencies-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](/blacksmith-cli/overview#token-types) 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.

```bash theme={"system"}
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`.

```bash theme={"system"}
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.