Text of cli.github.com › manual › gh_run_watch as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

GitHub CLI | Take GitHub to the command line

CLI manual gh run watch gh run watch <run-id> [flags] Watch a run until it completes, showing its progress. By default, all steps are displayed. The --compact option can be used to only show the relevant/failed steps. 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. This command polls the run. To wait for the workflow runs of a pull request on github.com to finish without polling, use gh event listen with the com.github.pull_request.check_suite.status.changed.v1 event instead.

Each check suite, such as a workflow run, sends its own event when it completes. Changes made before the listener starts are not reported, so read the checks once it is listening. Options --compact Show only relevant/failed steps --exit-status Exit with non-zero status if run fails -i , --interval <int> (default 3) Refresh interval in seconds Options inherited from parent commands -R , --repo <[HOST/]OWNER/REPO> Select another repository using the [HOST/]OWNER/REPO format Examples # Watch a run until it's done $ gh run watch # Watch a run in compact mode $ gh run watch --compact # Run some other command when the run is finished $ gh run watch && notify-send 'run is done!' See also gh run