Scroll to navigation

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 disabled workflows. Also pass the -a flag to fetch disabled workflow runs using the workflow_name and the -w flag.

OPTIONS

Include disabled workflows

Filter runs by branch

Filter runs by the SHA of the commit

Filter runs by the date it was created

Filter runs by which event triggered the run

Filter JSON output using a jq expression

Output JSON with the specified fields

Maximum number of runs to fetch

Filter runs by status: {queued|completed|in_progress|requested|waiting|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out}

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

Filter runs by user who triggered the run

Filter runs by workflow

OPTIONS INHERITED FROM PARENT COMMANDS

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

ALIASES

gh run ls

JSON FIELDS

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

SEE ALSO

gh-run(1)

Jul 2024 GitHub CLI v2.52.0