aibot88 GitHub CLI Operations
Use GitHub CLI (gh) to interact with GitHub repositories, pull requests, issues, and workflows.
Prerequisites
- GitHub CLI installed:
brew install gh(macOS) or see cli.github.com - Authenticated:
gh auth login(one-time setup) - Repository context: Run commands from within a git repository or specify
--repo owner/repo
Quick Start
Get PR details:
gh pr view <pr-number> --json title,body,author,state
Get PR diff:
gh pr diff <pr-number>
Extract Linear issue references:
gh pr view <pr-number> --json body --jq '.body' | grep -oE 'LIN-[0-9]+'
Usage Patterns for PR Review
Get PR Context
Get PR title, description, and metadata:
gh pr view <pr-number> --json title,body,author,state,baseRefName,headRefName
Get changed files:
gh pr view <pr-number> --json files --jq '.files[].path'
Get diff for specific file:
gh pr diff <pr-number> -- path/to/file
Check PR Status
Check CI status:
gh pr checks <pr-number>
Check if PR is mergeable:
gh pr view <pr-number> --json mergeable,mergeStateStatus
Link to Linear Issues
Extract issue references from PR body:
gh pr view <pr-number> --json body --jq '.body' | grep -oE 'LIN-[0-9]+'
Integration with Linear
When reviewing PRs, extract Linear issue references from:
- PR title: Look for
LIN-123or[LIN-123]patterns - PR body: Search for Linear issue links or IDs
- PR comments: Check for issue mentions
Then use Linear MCP functions to fetch issue details and requirements.
Reference Documentation
- Command Reference: See commands.md for complete GitHub CLI command reference
- GitHub CLI Manual: cli.github.com/manual