GitHub PR Management

Use the gh CLI for all GitHub PR operations. This avoids MCP overhead while providing full PR workflow support.

Common Workflows

Review a PR

bash
1# View PR details
2gh pr view <number>
3
4# View PR diff
5gh pr diff <number>
6
7# View PR checks/CI status
8gh pr checks <number>
9
10# View PR review comments
11gh pr view <number> --comments
12
13# Checkout PR locally for testing
14gh pr checkout <number>

Create a PR

bash
1# Create with title and body
2gh pr create --title "Title" --body "$(cat <<'EOF'
3## Summary
4- Change description
5
6## Test plan
7- [ ] Test steps
8
9🤖 Generated with [Claude Code](https://claude.com/claude-code)
10EOF
11)"
12
13# Create as draft
14gh pr create --draft --title "WIP: Title" --body "Description"

Manage PRs

bash
1# List open PRs
2gh pr list
3
4# Merge a PR
5gh pr merge <number> --squash
6
7# Close a PR
8gh pr close <number>
9
10# Add reviewers
11gh pr edit <number> --add-reviewer username
12
13# View PR as JSON for programmatic access
14gh pr view <number> --json title,body,state,reviews,checks

Check CI Status

bash
1# View all checks for current branch
2gh pr checks
3
4# View specific run details
5gh run view <run-id>
6
7# View run logs
8gh run view <run-id> --log-failed

Best Practices

• Always use --json flag when you need structured data for analysis
• Use gh pr diff to review changes before approving
• Check gh pr checks before merging to ensure CI passes
• When creating PRs, always include a test plan section