Gh CLI

Gh CLI

This skill provides guidance for using the GitHub CLI (gh) to automate and streamline GitHub workflows.

Common workflows

Actions & runs

• List recent runs: gh run list
• View a specific run: gh run view <run-id>
• View job logs: gh run view <run-id> --job <job-id> --log
• Rerun failed jobs: gh run rerun <run-id> --failed

Pull requests

• List PRs: gh pr list
• View PR details: gh pr view <pr-number>
• Check PR status: gh pr status
• Create a PR: gh pr create --title "..." --body "..."
• Merge a PR: gh pr merge <pr-number> --merge (or --squash, --rebase)

Issues

• List issues: gh issue list
• View issue: gh issue view <issue-number>
• Create issue: gh issue create --title "..." --body "..."

Best practices

• Use --repo: When working in a multi-repo context or if not in a git repo, always specify --repo <owner>/<repo>.
• JSON Output: Use --json with -q (jq filter) for scriptable output.
• Help: Use gh <command> --help to discover more flags.

See references/commands.md for a comprehensive list of commands and examples.