gh-run - Man Page
View details about workflow runs
Examples (TL;DR)
- 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 --job=job_number
- Display the log of a job:
gh run view --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
Synopsis
gh run <command> [flags]
Description
List, view, and watch recent workflow runs from GitHub Actions.
Available Commands
- gh-run-cancel(1)
Cancel a workflow run
- gh-run-delete(1)
Delete a workflow run
- gh-run-download(1)
Download artifacts generated by a workflow run
- gh-run-list(1)
List recent workflow runs
- gh-run-rerun(1)
Rerun a run
- gh-run-view(1)
View a summary of a workflow run
- gh-run-watch(1)
Watch a run until it completes, showing its progress
Options
- -R, --repo <[HOST/]OWNER/REPO>
Select another repository using the [HOST/]OWNER/REPO format
See Also
Referenced By
gh(1), gh-run-cancel(1), gh-run-delete(1), gh-run-download(1), gh-run-list(1), gh-run-rerun(1), gh-run-view(1), gh-run-watch(1).
Jul 2024 GitHub CLI manual