`gh run list` List recent GitHub Actions workflow runs

Shows the latest runs of your repository's automated workflows with their status, branch and age. Use it to find a failing run, then view its log.

Synopsis

gh run list [FLAGS]

Option or form	What it does
`-w, --workflow NAME`	Only runs of that workflow
`-b, --branch NAME`	Only runs on a branch
`-s, --status STATUS`	Filter by status, such as failure or success
`-L, --limit N`	How many to show (default 20)
`-u, --user NAME`	Only runs triggered by a user
`--json FIELDS`	Output fields as JSON

See recent runs

gh run list

completed  success  Fix typo  build  main  push  1m4s

Only failures

gh run list --status failure

Runs on one branch

gh run list --branch feature/search

Runs of one workflow

gh run list --workflow build.yml

Show a run's failing logs

gh run view 123456789 --log-failed

The run ID is in the first columns of the output or in the URL on GitHub.
Use gh run watch RUN-ID to follow a run live and gh run rerun RUN-ID --failed to try again.
Workflows are defined in .github/workflows/ in the repository.