gh Verified current stable Not installed? Version Control

Gh / Interactively Select Active Run And Wait

Interactively Select Active Run And Wait

Watch the currently active GitHub Actions runs interactively.

$
Terminal
gh run watch

When To Use

When immediate feedback on active jobs is necessary during a deployment process.

Pro Tip

Utilizing `--once` allows you to exit after the first change, useful for quick checks during CI runs.

Anatomy of Output

Understanding the result

Run ID: 54321 Run Identifier

ID for the currently monitored run.

Status: in progress Run Status

Current execution status of the active job.

Triggered by: push Trigger Event

Indicates what initiated the workflow run.

Power User Variants

Optimized versions

gh run watch --json

Output active run details in JSON format.

gh run watch --once

Terminate after the first status update.

Troubleshooting

Common pitfalls

Error: No active runs to watch.

Solution: Verify that there are ongoing workflows in the repository.

Error: Watch command failed due to connection issues.

Solution: Check your internet connection and GitHub API status.

Error: Authentication required to access runs.

Solution: Authenticate properly to have the necessary visibility.

Command Breakdown

What each part is doing

gh
Base Command
The executable that performs this operation. Here it runs Gh before the shell applies any redirect operators.

Alternative Approaches

Comparable commands in other tools

Alternative version control tools for the same job.