.nh
.TH "GH-RUN-LIST" "1" "Apr 2026" "" "GitHub CLI manual"

.SH NAME
gh-run-list - List recent workflow runs


.SH SYNOPSIS
\fBgh run list [flags]\fR


.SH DESCRIPTION
List recent workflow runs.

.PP
Note that providing the \fBworkflow_name\fR to the \fB-w\fR flag will not fetch disabled workflows.
Also pass the \fB-a\fR flag to fetch disabled workflow runs using the \fBworkflow_name\fR and the \fB-w\fR flag.

.PP
Runs created by organization and enterprise ruleset workflows will not display a workflow name due to GitHub API limitations.

.PP
To see runs associated with a pull request, users should run \fBgh pr checks\fR\&.


.SH OPTIONS
.TP
\fB-a\fR, \fB--all\fR
Include disabled workflows

.TP
\fB-b\fR, \fB--branch\fR \fB<string>\fR
Filter runs by branch

.TP
\fB-c\fR, \fB--commit\fR \fB<SHA>\fR
Filter runs by the SHA of the commit

.TP
\fB--created\fR \fB<date>\fR
Filter runs by the date it was created

.TP
\fB-e\fR, \fB--event\fR \fB<event>\fR
Filter runs by which event triggered the run

.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
Filter JSON output using a jq expression

.TP
\fB--json\fR \fB<fields>\fR
Output JSON with the specified fields

.TP
\fB-L\fR, \fB--limit\fR \fB<int> (default 20)\fR
Maximum number of runs to fetch

.TP
\fB-s\fR, \fB--status\fR \fB<string>\fR
Filter runs by status: {queued|completed|in_progress|requested|waiting|pending|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out}

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
Format JSON output using a Go template; see "gh help formatting"

.TP
\fB-u\fR, \fB--user\fR \fB<string>\fR
Filter runs by user who triggered the run

.TP
\fB-w\fR, \fB--workflow\fR \fB<string>\fR
Filter runs by workflow


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
Select another repository using the [HOST/]OWNER/REPO format


.SH ALIASES
gh run ls


.SH JSON FIELDS
\fBattempt\fR, \fBconclusion\fR, \fBcreatedAt\fR, \fBdatabaseId\fR, \fBdisplayTitle\fR, \fBevent\fR, \fBheadBranch\fR, \fBheadSha\fR, \fBname\fR, \fBnumber\fR, \fBstartedAt\fR, \fBstatus\fR, \fBupdatedAt\fR, \fBurl\fR, \fBworkflowDatabaseId\fR, \fBworkflowName\fR


.SH EXIT CODES
0: Successful execution

.PP
1: Error

.PP
2: Command canceled

.PP
4: Authentication required

.PP
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.


.SH SEE ALSO
\fBgh-run(1)\fR