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 dis- abled workflows. Also pass the -a flag to fetch disabled workflow runs us- ing the workflow_name and the -w flag. Runs created by organization and enterprise ruleset workflows will not dis- play a workflow name due to GitHub API limitations. To see runs associated with a pull request, users should run gh pr checks. 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|requested|wait- ing|pending|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, workflow- DatabaseId, 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 com- mand's help for more information. SEE ALSO gh-run(1) Aug 2026 GH-RUN-LIST(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPTIONS INHERITED FROM PARENT COMMANDS | ALIASES | JSON FIELDS | EXIT CODES | SEE ALSO
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+15.1.quarterly>