GitHub CLI
Master the gh CLI for GitHub operations without leaving the terminal.
Core Commands
Pull Requests
# Create PR from current branch
gh pr create --title "Title" --body "Description"
# Create PR with template
gh pr create --fill # Uses commit messages
# Create draft PR
gh pr create --draft
# List PRs
gh pr list
gh pr list --state all --author @me
# View/checkout PR
gh pr view 123
gh pr checkout 123
# Merge PR
gh pr merge 123 --squash --delete-branch
# Review PR
gh pr review 123 --approve
gh pr review 123 --request-changes --body "Please fix X"
Issues
# Create issue
gh issue create --title "Bug" --body "Description"
gh issue create --label bug,urgent --assignee @me
# List issues
gh issue list
gh issue list --label "bug" --state open
# View/close
gh issue view 456
gh issue close 456 --comment "Fixed in #123"
Releases
# Create release
gh release create v1.0.0 --title "v1.0.0" --notes "Release notes"
# Create with auto-generated notes
gh release create v1.0.0 --generate-notes
# Upload assets
gh release create v1.0.0 ./dist/*.zip
# List releases
gh release list
Actions/Workflows
# List workflow runs
gh run list
# View run details
gh run view 12345
# Watch running workflow
gh run watch
# Rerun failed jobs
gh run rerun 12345 --failed
# Trigger workflow
gh workflow run deploy.yml -f environment=production
Repository
# Clone
gh repo clone owner/repo
# Create new repo
gh repo create my-repo --public --clone
# Fork
gh repo fork owner/repo --clone
# View repo
gh repo view owner/repo --web
Gists
# Create gist
gh gist create file.txt --public
gh gist create file1.txt file2.txt --desc "My gist"
# List gists
gh gist list
# Edit gist
gh gist edit <gist-id>
Advanced Patterns
API Access
# GET request
gh api repos/owner/repo/issues
# POST request
gh api repos/owner/repo/issues -f title="Bug" -f body="Details"
# GraphQL
gh api graphql -f query='{ viewer { login } }'
# Pagination
gh api repos/owner/repo/issues --paginate
JSON Output & jq
# Get PR as JSON
gh pr view 123 --json title,state,author
# List with specific fields
gh pr list --json number,title,author --jq '.[] | "\(.number): \(.title)"'
Aliases
# Create alias
gh alias set pv 'pr view'
gh alias set co 'pr checkout'
# Use alias
gh pv 123
Reference
For detailed command options: references/commands.md