gh-complete

Comprehensive GitHub CLI skill with GraphQL, REST API, and workflow automation.

Quick Reference

Authentication

gh auth login                    # Interactive login
gh auth login --with-token < token.txt
gh auth status                   # Check auth state
gh auth token                    # Print current token
gh auth refresh -s repo,read:org # Refresh with scopes

Repository Operations

gh repo clone owner/repo
gh repo create name --public --source=. --push
gh repo fork owner/repo --clone
gh repo view [repo] --web
gh repo list owner --limit 100
gh repo archive owner/repo
gh repo delete owner/repo --yes
gh repo rename new-name
gh repo sync                     # Sync fork with upstream

Pull Requests

gh pr create --title "T" --body "B" --base main
gh pr create --fill              # From commit messages
gh pr create --draft
gh pr list --state open --author @me
gh pr view 123 --comments
gh pr checkout 123
gh pr diff 123
gh pr merge 123 --squash --delete-branch
gh pr ready 123                  # Mark ready for review
gh pr review 123 --approve
gh pr review 123 --request-changes --body "Fix X"
gh pr close 123
gh pr reopen 123
gh pr edit 123 --add-label bug --add-reviewer user

Issues

gh issue create --title "T" --body "B"
gh issue create --label bug,urgent --assignee @me
gh issue list --state open --label bug
gh issue view 42 --comments
gh issue close 42 --reason completed
gh issue reopen 42
gh issue edit 42 --add-label priority
gh issue transfer 42 owner/other-repo
gh issue pin 42
gh issue develop 42 --checkout   # Create branch for issue

Actions & Workflows

gh run list                      # List workflow runs
gh run view 12345                # View run details
gh run view 12345 --log          # View logs
gh run watch 12345               # Watch live
gh run rerun 12345               # Rerun failed
gh run cancel 12345
gh workflow list
gh workflow view deploy.yml
gh workflow run deploy.yml -f env=prod
gh workflow enable deploy.yml
gh workflow disable deploy.yml

REST API

gh api repos/{owner}/{repo}
gh api repos/{owner}/{repo}/issues --method POST \
  -f title="Bug" -f body="Description"
gh api /user --jq '.login'
gh api orgs/{org}/repos --paginate
gh api graphql -f query='{ viewer { login } }'

GraphQL API

# Get viewer info
gh api graphql -f query='
  query {
    viewer {
      login
      repositories(first: 10) {
        nodes { name stargazerCount }
      }
    }
  }'

# Mutation example
gh api graphql -f query='
  mutation($id: ID!) {
    addStar(input: {starrableId: $id}) {
      starrable { stargazerCount }
    }
  }' -f id="MDEwOlJlcG9zaXRvcnkx"

# With variables file
gh api graphql -F query=@query.graphql -F variables=@vars.json

Gists

gh gist create file.txt --public
gh gist create file1.txt file2.txt --desc "My gist"
gh gist list --public
gh gist view abc123
gh gist edit abc123
gh gist delete abc123
gh gist clone abc123

Releases

gh release create v1.0.0 --generate-notes
gh release create v1.0.0 ./dist/* --title "Release v1.0.0"
gh release list
gh release view v1.0.0
gh release download v1.0.0
gh release delete v1.0.0 --yes
gh release edit v1.0.0 --draft=false

SSH Keys & GPG

gh ssh-key list
gh ssh-key add ~/.ssh/id_ed25519.pub --title "My Key"
gh ssh-key delete 12345
gh gpg-key list
gh gpg-key add key.gpg

Extensions

gh extension list
gh extension install owner/gh-ext
gh extension upgrade --all
gh extension remove gh-ext
gh extension create my-ext       # Scaffold new extension
gh extension browse              # Discover extensions

Search

gh search repos "query" --language=rust --stars=">1000"
gh search issues "bug" --state=open --repo=owner/repo
gh search prs "fix" --merged --author=user
gh search code "function" --repo=owner/repo
gh search commits "fix bug" --author=user

Codespaces

gh codespace list
gh codespace create -r owner/repo
gh codespace ssh -c codespace-name
gh codespace code -c codespace-name  # Open in VS Code
gh codespace stop -c codespace-name
gh codespace delete -c codespace-name

Projects (v2)

gh project list --owner @me
gh project view 1 --owner @me
gh project create --title "My Project"
gh project item-list 1 --owner @me
gh project item-add 1 --owner @me --url https://github.com/owner/repo/issues/1

Labels & Milestones

gh label list
gh label create "priority:high" --color FF0000
gh label delete "old-label"
# Milestones via API
gh api repos/{owner}/{repo}/milestones --method POST -f title="v2.0"

Aliases

gh alias set pv 'pr view'
gh alias set co 'pr checkout'
gh alias list
gh alias delete pv

Config

gh config set editor vim
gh config set git_protocol ssh
gh config get editor
gh config list

Environment Variables

GH_TOKEN=xxx gh api /user        # Override auth
GH_HOST=github.example.com       # GitHub Enterprise
GH_REPO=owner/repo               # Default repo
GH_DEBUG=1                       # Debug output
NO_COLOR=1                       # Disable colors

Patterns

Bulk Operations

# Close all issues with label
gh issue list --label stale --json number -q '.[].number' | \
  xargs -I {} gh issue close {}

# Add label to all open PRs
gh pr list --json number -q '.[].number' | \
  xargs -I {} gh pr edit {} --add-label needs-review

JSON Processing

# Get PR authors
gh pr list --json author --jq '.[].author.login' | sort -u

# Format output
gh repo list --json name,stargazerCount \
  --template '{{range .}}{{.name}}: {{.stargazerCount}}{{"\n"}}{{end}}'

CI Integration

# Wait for checks
gh pr checks 123 --watch

# Get check status
gh pr view 123 --json statusCheckRollup -q '.statusCheckRollup[].state'

GF(3) Assignment

Trit: 0 (ERGODIC) - Coordinator
Hue: 210° (GitHub blue)

Triads:

• gh-complete (0) × git (-1) × github-actions (+1) = 0 ✓
• gh-complete (0) × code-review (-1) × pr-automation (+1) = 0 ✓