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

FreeBSD Manual Pages

  
 
  

home | help
GH-RUN-LIST(1)		       GitHub CLI manual		GH-RUN-LIST(1)

NAME
       gh-run-list - List recent workflow runs

SYNOPSIS
       gh run list [flags]

DESCRIPTION
       List recent workflow runs.

       Note  that  providing  the  workflow_name to the	-w flag	will not fetch
       disabled	workflows.  Also pass the -a flag to fetch  disabled  workflow
       runs using the workflow_name and	the -w flag.

OPTIONS
       -a, --all
	      Include disabled workflows

       -b, --branch <string>
	      Filter runs by branch

       -c, --commit <SHA>
	      Filter runs by the SHA of	the commit

       --created <date>
	      Filter runs by the date it was created

       -e, --event <event>
	      Filter runs by which event triggered the run

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

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

       -L, --limit <int> (default 20)
	      Maximum number of	runs to	fetch

       -s, --status <string>
	      Filter   runs   by   status:   {queued|completed|in_progress|re-
	      quested|waiting|action_required|cancelled|failure|neu-
	      tral|skipped|stale|startup_failure|success|timed_out}

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

       -u, --user <string>
	      Filter runs by user who triggered	the run

       -w, --workflow <string>
	      Filter runs by workflow

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

ALIASES
       gh run ls

JSON FIELDS
       attempt,	conclusion, createdAt, databaseId, displayTitle, event,	 head-
       Branch, headSha,	name, number, startedAt, status, updatedAt, url, work-
       flowDatabaseId, workflowName

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.

SEE ALSO
       gh-run(1)

				   Apr 2025			GH-RUN-LIST(1)

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

home | help