Command referencegh run list
gh run list command (Linux & Windows / GitHub CLI)
What it does
List recent GitHub Actions workflow runs for the repository. When people search for gh run list, they usually want practical GitHub CLI flags, safe examples, and how this subcommand fits everyday PR and repo workflows on Linux, Windows, and macOS. Syntax, options, and copyable examples are below.
List recent GitHub Actions workflow runs for the repository.
Syntax
gh run list [flags]
Common options
| Flag / option | Meaning |
|---|---|
| -w, --workflow | Filter by workflow name or filename. |
| -b, --branch | Filter by branch. |
| -s, --status | Filter by status (queued, completed, etc.). |
| -L, --limit | Number of runs to show. |
| --json | Machine-readable output. |
Practical examples
Recent runs
gh run list
Shows the latest Actions runs with status and titles.
One workflow
gh run list --workflow ci.yml
Limits output to a single workflow file.
Failed only
gh run list --status failure --limit 5
Helps find recent failing runs quickly.
Common mistakes
- Copying the wrong run ID into `gh run view`.
- Filtering by job name instead of workflow filename.
Related commands
- gh run viewInspect a GitHub Actions run, including jobs, annotations, and optional logs.
- gh run watchWatch a GitHub Actions run until it completes, printing progress updates.
- gh workflow runTrigger a workflow_dispatch event for a GitHub Actions workflow.
- gh pr checksShow GitHub Actions and status-check results for a pull request.
- gh auth loginAuthenticate the GitHub CLI with GitHub.com or GitHub Enterprise so other gh commands can run.
- gh pr createCreate a pull request from the current branch with title, body, reviewers, and base branch options.
- gh pr mergeMerge a pull request using merge commit, squash, or rebase strategies.
- gitTrack source history and collaborate through distributed repositories.
FAQ
What does gh run list do in GitHub CLI?
List recent GitHub Actions workflow runs for the repository.
Does gh run list work on Windows and Linux?
Yes. The GitHub CLI (`gh`) runs on Linux, Windows, and macOS with the same subcommand syntax after you authenticate with `gh auth login`.
What is a practical gh run list example?
Try `gh run list` — Shows the latest Actions runs with status and titles.
Do I need a token in the command line for gh run list?
Prefer `gh auth login` so credentials stay in the system keyring or secure storage. Avoid pasting personal access tokens into shell history.
Browse the full Linux and Windows command reference to search more bash, CMD, PowerShell, Conda, and GitHub CLI commands.