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

FreeBSD Manual Pages

  
 
  

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

				   Apr 2025		      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+14.3.quarterly>

home | help