.nh
.TH "GH-RUN-LIST" "1" "Mar 2024" "" "GitHub CLI manual"

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


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


.SH OPTIONS
.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|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 SEE ALSO
.PP
\fBgh-run(1)\fR