# gh run watch

Follow an Actions run in real time.

## Quick answer
```
gh run watch
```

## Syntax
```
gh run watch [<run-id>] [flags]
```

## Examples

# Pick a recent run and watch it
gh run watch

# Watch a specific run by ID
gh run watch 8123456789

# Fail the shell if the run fails
gh run watch 8123456789 --exit-status

# Compact single-line output
gh run watch --compact

# Custom refresh interval
gh run watch 8123456789 --interval 5

## Key flags

  --exit-status	Exit with a non-zero code if the run fails.
  -i, --interval	Refresh interval in seconds (default 3).
  --compact	Show only the most relevant, in-progress steps.

Full guide: https://ghcli.com/gh-run-watch.php