Scroll to navigation

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

Filter JSON output using a jq expression

Output JSON with the specified fields

Filter by cache key prefix

Maximum number of caches to fetch

Order of caches returned: {asc|desc}

Filter by ref, formatted as refs/heads/ or refs/pull//merge

Sort fetched caches: {created_at|last_accessed_at|size_in_bytes}

Format JSON output using a Go template; see "gh help formatting"

OPTIONS INHERITED FROM PARENT COMMANDS

Select another repository using the [HOST/]OWNER/REPO format

ALIASES

gh cache ls

JSON FIELDS

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

EXIT CODES

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

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)

Oct 2024 GitHub CLI v2.58.0