Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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

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 com-
     mand'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

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

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

				    Aug 2026			GH-CACHE-LIST(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-cache-list&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help