gh-run-watch - Man Page
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.
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
- --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 command's help for more information.
Example
# Watch a run until it's done gh run watch # Run some other command when the run is finished gh run watch && notify-send 'run is done!'
See Also
Referenced By
Dec 2024 GitHub CLI manual