Skip to main content

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.

Experimental
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 and restore, which transfer cache content and run only inside a runner.

Configure the CI Cache

Configure the cache in your atmos.yaml.

atmos ci cache list

Usage​

atmos ci cache list [flags]

Examples​

# 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.