GH-RUN-LIST(1)                 GitHub CLI manual                GH-RUN-LIST(1)



NAME
       gh-run-list - List recent workflow runs



SYNOPSIS
       gh run list [flags]



OPTIONS
       -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|waiting|action_required|cancelled|failure|neutral|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



JSON FIELDS
       conclusion, createdAt, databaseId, displayTitle, event, headBranch,
       headSha, name, number, startedAt, status, updatedAt, url,
       workflowDatabaseId, workflowName



SEE ALSO
       gh-run(1)

                                   May 2024                     GH-RUN-LIST(1)