GH-CACHE-LIST(1)               GitHub CLI manual              GH-CACHE-LIST(1)



NAME
       gh-cache-list - List GitHub Actions caches



SYNOPSIS
       gh cache list [flags]



OPTIONS
       -q, --jq <expression>
              Filter JSON output using a jq expression


       --json <fields>
              Output JSON with the specified fields


       -k, --key <string>
              Filter by cache key prefix


       -L, --limit <int> (default 30)
              Maximum number of caches to fetch


       -O, --order <string> (default "desc")
              Order of caches returned: {asc|desc}


       -r, --ref <string>
              Filter by ref, formatted as refs/heads/ or refs/pull//merge


       -S, --sort <string> (default "last_accessed_at")
              Sort fetched caches: {created_at|last_accessed_at|size_in_bytes}


       -t, --template <string>
              Format JSON output using a Go template; see "gh help formatting"



OPTIONS INHERITED FROM PARENT COMMANDS
       -R, --repo <[HOST/]OWNER/REPO>
              Select another repository using the [HOST/]OWNER/REPO format



JSON FIELDS
       createdAt, id, key, lastAccessedAt, ref, sizeInBytes, version



EXAMPLE
       # List caches for current repository
       $ gh cache list

       # List caches for specific repository
       $ gh cache list --repo cli/cli

       # List caches sorted by least recently accessed
       $ gh cache list --sort last_accessed_at --order asc

       # List caches that have keys matching a prefix (or that match exactly)
       $ gh cache list --key key-prefix

       # To list caches for a specific branch, replace <branch-name> with the actual branch name
       $ gh cache list --ref refs/heads/<branch-name>

       # To list caches for a specific pull request, replace <pr-number> with the actual pull request number
       $ gh cache list --ref refs/pull/<pr-number>/merge




SEE ALSO
       gh-cache(1)

                                   May 2024                   GH-CACHE-LIST(1)