GH-RUN-WATCH(1) GitHub CLI manual GH-RUN-WATCH(1) NAME gh-run-watch - Watch a run until it completes, showing its progress SYNOPSIS gh run watch <run-id> [flags] DESCRIPTION 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. 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 EXIT CODES 0: Successful execution 1: Error 2: Command canceled 4: Authentication required NOTE: Specific commands may have additional exit codes. Refer to the com- mand's help for more information. EXAMPLE # 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(1) Aug 2026 GH-RUN-WATCH(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPTIONS INHERITED FROM PARENT COMMANDS | EXIT CODES | EXAMPLE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-run-watch&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>