english/.opencode/skills/git/references/gh-cli-guide.md

GitHub CLI Guide

Authentication

gh auth login        # Interactive login
gh auth status       # Check auth state
gh auth logout       # Logout

Pull Requests

Create PR

# Basic
gh pr create --base main --head feature-branch --title "feat: add login" --body "Summary"

# With HEREDOC body
gh pr create --base main --title "feat(auth): add OAuth" --body "$(cat <<'EOF'
## Summary
- Added OAuth2 provider support
- Implemented token refresh

## Test plan
- [ ] Unit tests pass
- [ ] Manual login test
EOF
)"

# Draft mode
gh pr create --draft --title "WIP: new feature"

# Assign reviewers
gh pr create --reviewer @user1,@user2

# Add labels
gh pr create --label "bug,priority:high"

View/Review PR

gh pr list                    # List PRs
gh pr view 123                # View PR details
gh pr view 123 --web          # Open in browser
gh pr checkout 123            # Checkout PR locally
gh pr diff 123                # View PR diff
gh pr status                  # Your PRs + reviews

Merge PR

gh pr merge 123               # Default merge commit
gh pr merge 123 --squash      # Squash commits
gh pr merge 123 --rebase      # Rebase merge
gh pr merge 123 --auto        # Auto-merge when checks pass
gh pr merge 123 --delete-branch  # Delete branch after

PR Comments

gh pr comment 123 --body "LGTM!"
gh api repos/{owner}/{repo}/pulls/123/comments  # View all

Issues

gh issue list                 # List issues
gh issue view 42              # View issue
gh issue create --title "Bug" --body "Description"
gh issue develop 42 -c        # Create branch from issue

Repository

gh repo view                  # Current repo info
gh repo clone owner/repo      # Clone
gh browse                     # Open repo in browser
gh browse path/to/file:42     # Open file at line

Workflow Runs

gh run list                   # List workflow runs
gh run view <run-id>          # View run details
gh run watch                  # Watch running workflow
gh run rerun <run-id>         # Rerun failed workflow

JSON Output (scripting)

gh pr list --json number,title,author
gh pr view 123 --json commits,reviews
gh issue list --json number,title --jq '.[].title'

Common Patterns

Create PR with auto-merge

gh pr create --fill && gh pr merge --auto --squash

Close stale PRs

gh pr list --state open --json number -q '.[].number' | xargs -I {} gh pr close {}