`gh pr checks` Show the CI check results for a pull request

Lists the status of automated checks such as tests and builds on a pull request. It can wait until they finish, which is handy in scripts.

Synopsis

gh pr checks [NUMBER | URL | BRANCH] [FLAGS]

Option or form	What it does
`--watch`	Keep refreshing until all checks finish
`--fail-fast`	With --watch, stop as soon as one check fails
`--required`	Only show required checks
`-w, --web`	Open the checks in the browser
`--json FIELDS`	Output as JSON
`-i, --interval N`	Seconds between refreshes with --watch

See checks for this branch

gh pr checks

build	pass	1m4s
test	fail	2m11s

Check a specific pull request

gh pr checks 42

Wait for it to finish

gh pr checks 42 --watch

Show only required checks

gh pr checks 42 --required

The exit code is 0 when all checks pass, 1 if one failed and 8 if checks are still pending, so scripts can act on it.
gh run view RUN-ID --log-failed shows the log of a failing check.
Add --watch before merging with --auto if you want to see the outcome.