snippetbashTip

gh run — View, run, and watch recent GitHub Actions workflow runs. More information: <https://cli.github.com/

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandrunandcliwatchrecentgh runview

Problem

How to use the gh run command: View, run, and watch recent GitHub Actions workflow runs. More information: <https://cli.github.com/manual/gh_run>.

Solution

gh run — View, run, and watch recent GitHub Actions workflow runs. More information: <https://cli.github.com/manual/gh_run>.

Interactively select a run to see information about the jobs:

gh run view

Display information about a specific run:

gh run view {{workflow_run_number}}

Display information about the steps of a job:

gh run view {{[-j|--job]}} {{job_number}}

Display the log of a job:

gh run view {{[-j|--job]}} {{job_number}} --log

Check a specific workflow and exit with a non-zero status if the run failed:

gh run view {{workflow_run_number}} --exit-status && {{echo "run pending or passed"}}

Interactively select an active run and wait until it's done:

gh run watch

Display the jobs for a run and wait until it's done:

gh run watch {{workflow_run_number}}

Re-run a specific workflow:

gh run rerun {{workflow_run_number}}

Code Snippets

Interactively select a run to see information about the jobs

gh run view

Display information about a specific run

gh run view {{workflow_run_number}}

Display information about the steps of a job

gh run view {{[-j|--job]}} {{job_number}}

Display the log of a job

gh run view {{[-j|--job]}} {{job_number}} --log

Check a specific workflow and exit with a non-zero status if the run failed

gh run view {{workflow_run_number}} --exit-status && {{echo "run pending or passed"}}

Context

tldr-pages: common/gh run

Revisions (0)

No revisions yet.