GitHub Actions

Monitor and manage GitHub Actions workflows with the gh CLI.

Prerequisites

GitHub CLI must be installed and authenticated:

gh auth status

Quick Reference

gh run list                         # List recent runs
gh run view 789                     # View run details
gh run view 789 --log               # View run logs
gh run watch 789                    # Watch running workflow
gh run rerun 789                    # Rerun workflow

List Workflow Runs

gh run list
gh run list --limit 10
gh run list --workflow ci.yml
gh run list --status failure
gh run list --branch main

View Run Details

gh run view 789
gh run view 789 --json status,conclusion,jobs

View Run Logs

gh run view 789 --log
gh run view 789 --log-failed  # Only failed job logs

Watch Running Workflow

gh run watch 789
gh run watch 789 --exit-status  # Exit with workflow status code

Rerun Workflows

gh run rerun 789
gh run rerun 789 --failed  # Rerun only failed jobs

List Workflows

gh workflow list
gh workflow view ci.yml