gh run view
gh run view [<run-id>] [flags]
View a summary of a workflow run.
This command does not support authenticating via fine grained PATs
as it is not currently possible to create a PAT with the checks:read permission.
Options
-a,--attempt <uint> (default 0)- The attempt number of the workflow run
-
--exit-status - Exit with non-zero status if run failed
-j,--job <string>- View a specific job ID from a run
-q,--jq <expression>- Filter JSON output using a jq expression
-
--json <fields> - Output JSON with the specified fields
-
--log - View full log for either a run or specific job
-
--log-failed - View the log for any failed steps in a run or specific job
-t,--template <string>- Format JSON output using a Go template; see "gh help formatting"
-v,--verbose- Show job steps
-w,--web- Open run in the browser
Options inherited from parent commands
-R,--repo <[HOST/]OWNER/REPO>- Select another repository using the [HOST/]OWNER/REPO format
JSON Fields
attempt, conclusion, createdAt, databaseId, displayTitle, event, headBranch, headSha, jobs, name, number, startedAt, status, updatedAt, url, workflowDatabaseId, workflowName
Examples
# Interactively select a run to view, optionally selecting a single job
$ gh run view
# View a specific run
$ gh run view 12345
# View a specific run with specific attempt number
$ gh run view 12345 --attempt 3
# View a specific job within a run
$ gh run view --job 456789
# View the full log for a specific job
$ gh run view --log --job 456789
# Exit non-zero if a run failed
$ gh run view 0451 --exit-status && echo "run pending or passed"