# atmos ci cache list

List CI cache entries, optionally filtered by key prefix. Newest entries are listed first. Supports table, JSON, YAML, CSV, and TSV output.

:::info Runs locally
`list` administers the cache over the provider's public API (the GitHub Actions caches REST API), so it works from your workstation as well as inside CI — you do not need to be running in a CI runner. It only needs a GitHub token (`GITHUB_TOKEN` / `ATMOS_GITHUB_TOKEN`, or `gh auth login`) and a GitHub repository (resolved from `GITHUB_REPOSITORY` or your local `git` remote). This is in contrast to [`save`](/cli/commands/ci/cache/save) and [`restore`](/cli/commands/ci/cache/restore), which transfer cache content and run only inside a runner.
:::

**Configure the CI Cache**

Configure the cache in your `atmos.yaml`.

CI Cache Configuration Reference[Read more](/cli/configuration/ci/cache)

## Usage

```shell
atmos ci cache list [flags]
```

## Examples

```shell
# List all cache entries
atmos ci cache list

# Filter by key prefix
atmos ci cache list --key="atmos-cache-linux-"

# JSON output for scripting
atmos ci cache list --format=json
```

## Output

In an interactive terminal, the `table` format shows a human-readable **Size** (e.g. `1.5 GB`) and **Age** (e.g. `2 hours ago`) for each entry. The machine-readable formats (`json`, `yaml`, `csv`, `tsv`) — and the `table` format when piped — keep the raw byte count and an absolute timestamp so the output stays easy to parse in scripts.

## Flags

- **`--key` / `-k`** — Filter entries by key prefix.
- **`--format`** — Output format: `table` (default), `json`, `yaml`, `csv`, or `tsv`.
- **`--delimiter`** — Delimiter for `csv`/`tsv` output.
- **`--max-columns`** — Maximum number of columns to display in table format (`0` = no limit).

## Environment Variables

- **`ATMOS_CI_CACHE_ENABLED`** — Must be `true` (or `ci.cache.enabled: true` in `atmos.yaml`) for the command to run.
- **`ATMOS_CI_CACHE_FORMAT`** — Overrides `--format`.

## Related

- [`atmos ci cache delete`](/cli/commands/ci/cache/delete) - Delete a cache entry
- [CI Cache Configuration](/cli/configuration/ci/cache) - Configure the cache