# Interactive — prompts for title, body, base branch, reviewers
gh pr create
 
# Non-interactive
gh pr create --title "Add login feature" --body "Implements OAuth login"
 
# Target a specific base branch
gh pr create --base develop
 
# Draft PR
gh pr create --draft --title "WIP: new feature"
 
# With metadata
gh pr create \
  --title "Fix bug #42" \
  --body "Closes #42" \
  --reviewer octocat,coworker \
  --assignee @me \
  --label bugfix \
  --milestone v2.0 \
  --project "Sprint Board"

# From inside your fork
gh pr create --repo upstream-owner/repo

# Default: 30 open PRs
gh pr list
 
# Filter by state
gh pr list --state closed
gh pr list --state merged
gh pr list --state all
 
# Filter by labels, author, assignee, base branch
gh pr list --label bugfix
gh pr list --author @me
gh pr list --assignee octocat
gh pr list --base main
 
# Search
gh pr list --search "login"
 
# Limit results
gh pr list --limit 100
 
# JSON output
gh pr list --json number,title,author --jq '.[] | "\(.number) \(.title)"'

# View in the terminal
gh pr view 123
 
# Open in the browser
gh pr view 123 --web
 
# View the current branch's PR
gh pr view
 
# JSON output
gh pr view 123 --json title,body,reviews,mergeable

gh pr checkout 123
 
# Checkout and create a custom local branch name
gh pr checkout 123 --branch my-local-name
 
# Checkout by branch name
gh pr checkout feature-branch
 
# Force (overwrite existing local branch)
gh pr checkout 123 --force

gh pr diff 123
 
# Diff with color
gh pr diff 123 --color always

# Interactive review (opens editor for comments)
gh pr review 123
 
# Approve
gh pr review 123 --approve
 
# Request changes
gh pr review 123 --request-changes --body "Please fix the typo on line 42"
 
# Comment (without approving or requesting changes)
gh pr review 123 --comment --body "Looks good, minor suggestion..."

# Open editor
gh pr comment 123
 
# Inline
gh pr comment 123 --body "Great work!"
 
# Comment in the browser
gh pr comment 123 --web

# See all status checks for a PR
gh pr checks 123
 
# Watch checks and wait for completion
gh pr checks 123 --watch
 
# Fail the command if any check fails (useful in scripts)
gh pr checks 123 --fail-fast

# Interactive (prompts for merge method)
gh pr merge 123
 
# Specific merge method
gh pr merge 123 --merge      # Merge commit
gh pr merge 123 --squash     # Squash and merge
gh pr merge 123 --rebase     # Rebase and merge
 
# Delete the branch after merge
gh pr merge 123 --delete-branch
 
# Auto-merge (merge automatically once checks pass)
gh pr merge 123 --auto --squash
 
# Disable auto-merge
gh pr merge 123 --disable-auto

gh pr close 123
gh pr close 123 --comment "Closing — no longer needed" --delete-branch
 
gh pr reopen 123

gh pr edit 123 --title "Updated title"
gh pr edit 123 --body "Updated description"
gh pr edit 123 --add-label enhancement --remove-label bug
gh pr edit 123 --add-reviewer octocat
gh pr edit 123 --base develop
gh pr edit 123 --milestone v2.0

gh pr ready 123

gh pr ready 123 --undo

gh pr revert 123
 
# With custom title and body
gh pr revert 123 --title "Revert: login changes" --body "Reverting due to regression"
 
# Create the revert as a draft
gh pr revert 123 --draft

# Default: merge base branch into PR branch
gh pr update-branch 123
 
# Use rebase instead of merge
gh pr update-branch 123 --rebase

gh pr lock 123 --reason resolved
gh pr unlock 123

gh pr status

# 1. Fork and clone
gh repo fork upstream-org/project --clone
cd project
 
# 2. Create a feature branch
git checkout -b fix-typo
 
# 3. Make changes and commit
echo "fixed" > file.txt
git add . && git commit -m "Fix typo in docs"
 
# 4. Create the PR (pushes the branch and opens the PR)
gh pr create --title "Fix typo in docs" --body "Fixes #42"
 
# 5. Watch CI checks
gh pr checks --watch
 
# 6. Merge when ready
gh pr merge --squash --delete-branch