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

# [NAME](#NAME)

gh-run-list - List recent workflow runs

# [SYNOPSIS](#SYNOPSIS)

**gh run list \[flags]**

# [DESCRIPTION](#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.

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

To see runs associated with a pull request, users should run **gh pr checks**.

# [OPTIONS](#OPTIONS)

[**-a**, **--all**](#a)

Include disabled workflows

[**-b**, **--branch** **&lt;string&gt;**](#b)

Filter runs by branch

[**-c**, **--commit** **&lt;SHA&gt;**](#c)

Filter runs by the SHA of the commit

[**--created** **&lt;date&gt;**](#created)

Filter runs by the date it was created

[**-e**, **--event** **&lt;event&gt;**](#e)

Filter runs by which event triggered the run

[**-q**, **--jq** **&lt;expression&gt;**](#q)

Filter JSON output using a jq expression

[**--json** **&lt;fields&gt;**](#json)

Output JSON with the specified fields

[**-L**, **--limit** **&lt;int&gt; (default 20)**](#L)

Maximum number of runs to fetch

[**-s**, **--status** **&lt;string&gt;**](#s)

Filter runs by status: {queued|completed|in\_progress|requested|waiting|pending|action\_required|cancelled|failure|neutral|skipped|stale|startup\_failure|success|timed\_out}

[**-t**, **--template** **&lt;string&gt;**](#t)

Format JSON output using a Go template; see "gh help formatting"

[**-u**, **--user** **&lt;string&gt;**](#u)

Filter runs by user who triggered the run

[**-w**, **--workflow** **&lt;string&gt;**](#w)

Filter runs by workflow

# [OPTIONS INHERITED FROM PARENT COMMANDS](#OPTIONS_INHERITED_FROM_PARENT_COMMANDS)

[**-R**, **--repo** **&lt;\[HOST/\]OWNER/REPO&gt;**](#R)

Select another repository using the \[HOST/]OWNER/REPO format

# [ALIASES](#ALIASES)

gh run ls

# [JSON FIELDS](#JSON_FIELDS)

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

# [EXIT CODES](#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](#SEE_ALSO)

[**gh-run(1)**](/man/os/gh/gh-run.1)

Oct 2026

---

Document: gh-run-list(1) from gh 2.103.2-r0 (Chainguard OS)
Source: https://github.com/cli/cli