List recent failed GitHub Actions runs with URLs
Build a paste-ready command, then review its compatibility and effects before running it.
gh run list --status failure --limit <count> --json workflowName,headBranch,conclusion,createdAt,url --jq '.[] | [.createdAt,.workflowName,.headBranch,.conclusion,.url] | @tsv'Complete required fields to copy the generated command.
Compatibility
Linux + macOS + WindowsVerified for Linux, macOS, Windows using bash, zsh, powershell syntax.
Operational knowledgereview due 2027-01-19
Requirementsghgh must be installed and available on PATH.Network accessThe target must be reachable from the current environment.
Version supportgh Current supported releasesVerified for linux, macos, windows using bash, zsh, powershell syntax; consult compatibility notes for platform-specific differences.
Expected signals2026-07-23T09:31:12Z CI main failure https://github.com/acme/api/actions/runs/1842Representative successful output; values vary with the selected target and system state.
Known errorsgh: command not foundgh is missing or is not available on PATH.
Verifygh run list --status failure --limit {{count}} --json workflowName,headBranch,conclusion,createdAt,url --jq '.[] | [.createdAt,.workflowName,.headBranch,.conclusion,.url] | @tsv'The output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01ghCommandRuns the gh stage of this one-liner.
02runArgumentPasses run to gh.
03listArgumentPasses list to gh.
04--statusOptionConfigures gh with the --status option.
05failureArgumentPasses failure to gh.
06--limitOptionRestricts the operation to the supplied target or maximum.
07<count>ParameterA value supplied in the Fill parameters section.
08--jsonOptionReturns the selected fields as structured JSON.
09workflowName,headBranch,conclusion,createdAt,urlArgumentPasses workflowName,headBranch,conclusion,createdAt,url to gh.
10--jqOptionConfigures gh with the --jq option.
11'.[] | [.createdAt,.workflowName,.headBranch,.conclusion,.url] | @tsv'ArgumentPasses '.[] | [.createdAt,.workflowName,.headBranch,.conclusion,.url] | @tsv' to gh.
This advanced community-curated one-liner combines several stages. Review every option and placeholder before running it.
Example input
gh run list --status failure --limit 3 --json workflowName,headBranch,conclusion,createdAt,url --jq '.[] | [.createdAt,.workflowName,.headBranch,.conclusion,.url] | @tsv'
Example output
2026-07-23T09:31:12Z CI main failure https://github.com/acme/api/actions/runs/1842
2026-07-22T18:02:44Z Deploy release/4.8 failure https://github.com/acme/api/actions/runs/1827
Illustrative output — exact values vary by system and data.
Official sources