# Watch Github Actions

Watch and monitor GitHub Actions workflow runs using the gh CLI.

- Repository: https://github.com/NVIDIA/OpenShell (20903 stars)
- Category: DevOps
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add NVIDIA/OpenShell --skill watch-github-actions -g -a claude-code -y`
Codex: `npx skills add NVIDIA/OpenShell --skill watch-github-actions -g -a codex -y`
Cursor: `npx skills add NVIDIA/OpenShell --skill watch-github-actions -g -a cursor -y`
Gemini CLI: `npx skills add NVIDIA/OpenShell --skill watch-github-actions -g -a gemini-cli -y`

## Description

Watch and monitor GitHub Actions workflow runs using the gh CLI. Use when the user wants to check workflow status, watch a running workflow, view CI/CD jobs, or monitor build progress. Trigger keywords - watch pipeline, pipeline status, CI status, check build, monitor CI, view pipeline, pipeline progress, workflow status, actions status.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Watch GitHub Actions

Monitor GitHub Actions workflow runs using the `gh` CLI.

## Prerequisites

- The `gh` CLI must be authenticated (`gh auth status`)
- You must be in a git repository with a GitHub remote

## Quick Status Check

List recent workflow runs for the current branch:

```bash
gh run list --branch "$(git branch --show-current)"
```

List all recent runs:

```bash
gh run list
```

## Watch a Run in Real Time

Watch a workflow run until it completes:

```bash
gh run watch
```

Watch a specific run:

```bash
gh run watch <run-id>
```

This will continuously update the status until the run finishes (success, failure, or cancelled).

## View Run Details

View a specific run with job details:

```bash
gh run view <run-id>
```

View with full log output:

```bash
gh run view <run-id> --log
```

View a failed job's log:

```bash
gh run view <run-id> --log-failed
```

## Check Runs for a Specific Branch

Current branch:

```bash
gh run list --branch "$(git branch --show-current)"
```

Specific branch:

```bash
gh run list --branch main
gh run list --branch feature-branch
```

## Check Runs for a PR

List workflow runs associated with a PR:

```bash
# Get the head branch of the PR, then list runs
BRANCH=$(gh pr view <pr-number> --json headRefName --jq '.headRefName')
gh run list --branch "$BRANCH"
```

Or view the checks directly on the PR:

```bash
gh pr checks <pr-number>
```

## List Recent Runs

List runs for the current project:

```bash
gh run list
```

Filter by status:

```bash
gh run list --status failure
gh run list --status success
gh run list --status in_progress
```

Filter by workflow:

```bash
gh run list --workflow "CI"
```

JSON output for scripting:

```bash
gh run list --json databaseId,status,headBranch,url --jq '.[] | {id: .databaseId, status: .status, branch: .headBranch, url: .url}'
```

## View Job Logs

The rest: https://github.com/NVIDIA/OpenShell/blob/HEAD/.agents/skills/watch-github-actions/SKILL.md