JSON output for scripting

gh pr checks --json name,state,conclusion


Exit codes: `0` = passed, `1` = failed, `8` = pending

## Viewing Failed Test Logs

```bash
# View run summary (interactive picker if no ID)
gh run view

# View specific run with job details
gh run view <run-id> -v

# View logs for failed steps only (most useful)
gh run view <run-id> --log-failed

# View full log for a specific job
gh run view --job <job-id> --log

# Open in browser
gh run view <run-id> --web

To get job ID from a URL like .../runs/123/job/456, job ID is 456.

Creating PRs

# Interactive (prompts for title/body)
gh pr create

# With title and body
gh pr create --title "Fix bug" --body "Details here"

# Auto-fill from commit messages
gh pr create --fill

# Draft PR
gh pr create --draft

# With reviewers and labels
gh pr create -r reviewer1,reviewer2 -l bug,urgent

# Specify base branch
gh pr create --base develop

Updating PRs

# Edit title/body
gh pr edit 123 --title "New title" --body "New body"

# Add/remove labels
gh pr edit 123 --add-label "bug" --remove-label "wip"

# Add/remove reviewers
gh pr edit 123 --add-reviewer alice --remove-reviewer bob

# Self-assign
gh pr edit 123 --add-assignee "@me"

# Change base branch
gh pr edit 123 --base main

Other Useful Commands

# View PR details
gh pr view 123

# View PR in browser
gh pr view 123 --web

# List open PRs
gh pr list

# Checkout PR locally
gh pr checkout 123

# View PR comments
gh api repos/{owner}/{repo}/issues/123/comments

# Re-run failed jobs
gh run rerun <run-id> --failed

Scripts

scripts/check-pr.sh - Check PR status with optional watch mode
scripts/view-failed-logs.sh - View failed logs for a run or job

github-cli

GitHub CLI for PR Workflows

Checking PR Status