gh-run
Manage GitHub Actions workflow runs
TLDR
List workflow runs
$ gh run list
View run details$ gh run view [run-id]
Watch a run$ gh run watch [run-id]
Download artifacts$ gh run download [run-id]
Rerun failed jobs$ gh run rerun [run-id] --failed
SYNOPSIS
gh run command [options]
DESCRIPTION
gh run manages GitHub Actions workflow runs from the command line. It provides visibility into CI/CD execution including logs, status, and artifacts without visiting github.com.The watch command provides live progress updates for running workflows. Download retrieves artifacts produced by workflows, and rerun enables retriggering workflows with options for full or partial reruns.
PARAMETERS
list
List recent workflow runs.view RUN-ID
View run details.watch RUN-ID
Watch run progress live.download RUN-ID
Download run artifacts.rerun RUN-ID
Rerun a workflow run.cancel RUN-ID
Cancel a running workflow.--workflow NAME
Filter by workflow name.--branch BRANCH
Filter by branch.--failed
Only rerun failed jobs.--help
Display help information.
INSTALL
sudo apt install gh
sudo dnf install gh
sudo pacman -S github-cli
sudo apk add github-cli
sudo zypper install gh
brew install gh
nix profile install nixpkgs#gh
CAVEATS
Requires Actions enabled on repository. Log access may be limited. Artifacts have retention limits.
HISTORY
gh run was added to the GitHub CLI alongside broader GitHub Actions integration, enabling workflow management from the command line.
SEE ALSO
gh(1), gh-workflow(1), gh-pr-checks(1)