---

name: gh-cli description: Use GitHub CLI (gh) for common operations like creating PRs, viewing GitHub Actions logs, managing issues, reviewing PRs, and more. Use this when you need to interact with GitHub repositories directly from the command line. license: MIT

GitHub CLI Operations

This skill provides quick access to common GitHub CLI operations for managing repositories, pull requests, issues, and GitHub Actions.

Requirements

• gh (GitHub CLI) - must be authenticated with your GitHub account
• Run gh auth login if not already authenticated

Common operations

Pull requests

Create a new PR:

Copygh pr create --title "Your PR title" --body "Description of changes"

Create a PR with auto-fill (from commit messages):

Copygh pr create --fill

Create a draft PR:

Copygh pr create --draft --title "WIP: Feature X"

List PRs:

Copy# List open PRs
gh pr list

# List all PRs (including closed)
gh pr list --state all

# List your PRs
gh pr list --author @me

View a PR:

Copy# View PR in terminal
gh pr view 123

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

Check out a PR locally:

Copygh pr checkout 123

Review a PR:

Copy# Approve
gh pr review 123 --approve

# Request changes
gh pr review 123 --request-changes --body "Please fix the typo"

# Comment
gh pr review 123 --comment --body "Looks good overall"

Merge a PR:

Copy# Merge with merge commit
gh pr merge 123

# Squash and merge
gh pr merge 123 --squash

# Rebase and merge
gh pr merge 123 --rebase

# Auto-merge when checks pass
gh pr merge 123 --auto --squash

GitHub Actions

List workflow runs:

Copy# List recent runs
gh run list

# List runs for a specific workflow
gh run list --workflow "CI"

# List failed runs
gh run list --status failure

View run details:

Copygh run view 1234567890

View run logs:

Copy# View all logs for a run
gh run view 1234567890 --log

# View logs for a specific job
gh run view 1234567890 --log --job "build"

Download run logs:

Copygh run download 1234567890

Re-run a workflow:

Copy# Re-run failed jobs
gh run rerun 1234567890 --failed

# Re-run all jobs
gh run rerun 1234567890

Watch a running workflow:

Copygh run watch 1234567890

Trigger a workflow manually:

Copygh workflow run workflow-name.yml

Issues

Create an issue:

Copygh issue create --title "Bug: Something broken" --body "Description here"

List issues:

Copy# List open issues
gh issue list

# List your issues
gh issue list --assignee @me

# List issues with a label
gh issue list --label bug

View an issue:

Copygh issue view 456

Comment on an issue:

Copygh issue comment 456 --body "Thanks for reporting this!"

Close/reopen an issue:

Copygh issue close 456
gh issue reopen 456

Repository operations

Clone a repository:

Copygh repo clone owner/repo

Create a repository:

Copy# Create public repo
gh repo create my-repo --public

# Create private repo with README
gh repo create my-repo --private --add-readme

View repository info:

Copygh repo view owner/repo

Fork a repository:

Copygh repo fork owner/repo --clone

Set default branch:

Copygh repo set-default owner/repo

Status and monitoring

Check CI status:

Copy# View checks for current branch
gh pr checks

# View checks for a specific PR
gh pr checks 123

View your notifications:

Copygh notify

Advanced usage

Use with specific repository:

Copygh pr list --repo owner/repo

Output as JSON for scripting:

Copygh pr list --json number,title,author,state

Use custom queries:

Copy# Search for PRs with label
gh pr list --label "needs-review"

# Search for issues assigned to you
gh issue list --assignee @me --state open

Tips

Check command help: Add --help to any command to see all options:

Copygh pr create --help

Interactive mode: Many commands support interactive prompts when you don't provide required flags:

Copygh pr create  # Will prompt for title, body, etc.

Aliases: Create custom aliases for frequently used commands:

Copygh alias set prc 'pr create --fill'

Default repository: Run gh repo set-default in a repo to avoid specifying --repo flag.

Common workflows

Creating a PR from current branch:

Copygit push -u origin feature-branch
gh pr create --fill

Checking why a PR failed:

Copygh pr checks 123
gh run view <run-id> --log

Quick PR review workflow:

Copygh pr list
gh pr view 123
gh pr checkout 123
# Make local tests/review
gh pr review 123 --approve

Monitoring a deployment:

Copygh run list --workflow "Deploy"
gh run watch <latest-run-id>