GitHub CLI로 Pull Request 관리하기

# GitHub CLI 패키지 저장소 추가
type -p curl >/dev/null || sudo apt install curl -y
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null

# 설치
sudo apt update
sudo apt install gh

sudo apt update
sudo apt install gh

brew install gh

# winget 사용
winget install --id GitHub.cli

# Chocolatey 사용
choco install gh

# Scoop 사용
scoop install gh

gh --version
# 출력 예시: gh version 2.40.0 (2024-01-15)

gh auth login

gh auth status

# GitHub Enterprise Server 인증
gh auth login --hostname github.mycompany.com

# 특정 범위(scope)로 인증
gh auth login --scopes "repo,read:org,workflow"

# Personal Access Token으로 인증
gh auth login --with-token < token.txt

cd path/to/your/repository
git fetch origin
git pull origin main  # 또는 해당 기본 브랜치 이름

git checkout -b feature/user-authentication
# 또는 git switch -c feature/user-authentication

git add .
git commit -m "feat: implement user authentication logic"

git push -u origin feature/user-authentication

gh pr create

gh pr create \
  --title "feat: implement user authentication" \
  --body "## Summary
- Add login/logout functionality
- Implement JWT token handling
- Add password validation

## Test Plan
- [ ] Unit tests for auth service
- [ ] Integration tests for login flow" \
  --base main \
  --assignee @me \
  --reviewer teammate1,teammate2 \
  --label "enhancement,auth"

# 초안 PR 생성 (아직 리뷰 준비가 안 된 경우)
gh pr create --draft --title "WIP: refactor payment module"

# 자신을 할당하고 특정 팀을 리뷰어로 지정
gh pr create --assignee @me --reviewer myorg/backend-team

# 웹에서 PR 페이지 열기
gh pr create --web

# 본문을 파일에서 읽어오기
gh pr create --title "Release v2.0.0" --body-file CHANGELOG.md

# 열린 PR 목록 (기본)
gh pr list

# 모든 상태의 PR 목록
gh pr list --state all

# 자신에게 할당된 PR
gh pr list --assignee @me

# 특정 레이블의 PR
gh pr list --label bug

# 복합 필터
gh pr list --assignee @me --label "bug,urgent" --state open

# 특정 브랜치를 대상으로 하는 PR
gh pr list --base main

# 최근 10개만 표시
gh pr list --limit 10

gh pr list --json number,title,author,state

# 특정 PR 조회
gh pr view 123

# 현재 브랜치의 PR 조회
gh pr view

# 웹 브라우저에서 열기
gh pr view 123 --web

# JSON 형식으로 특정 필드만 조회
gh pr view 123 --json title,body,state,reviews

# PR 번호로 체크아웃
gh pr checkout 123

# 체크아웃 후 원래 브랜치로 돌아가기
git checkout -

gh pr status

# CI 체크 상태 확인
gh pr checks 123

# 체크가 완료될 때까지 대기
gh pr checks 123 --watch

# 실패한 체크만 표시
gh pr checks 123 --fail-only

# 리뷰어 추가
gh pr edit 123 --add-reviewer username1,username2

# 팀을 리뷰어로 지정
gh pr edit 123 --add-reviewer myorg/frontend-team

# 리뷰어 제거
gh pr edit 123 --remove-reviewer username1

# 현재 브랜치의 PR에 리뷰어 추가
gh pr edit --add-reviewer username1

# PR의 diff 확인
gh pr diff 123

# 특정 파일의 diff만 확인 (파이프와 grep 활용)
gh pr diff 123 | grep -A 20 "filename.js"

# 승인
gh pr review 123 --approve --body "코드 검토 완료, 잘 작성되었습니다."

# 변경 요청
gh pr review 123 --request-changes --body "다음 부분을 수정해주세요:
- 에러 핸들링 추가 필요
- 테스트 커버리지 부족"

# 코멘트만 남기기 (승인/거절 없이)
gh pr review 123 --comment --body "몇 가지 제안사항이 있습니다..."

# 대화형 모드로 리뷰 (편집기가 열림)
gh pr review 123

# PR에 코멘트 추가
gh pr comment 123 --body "빌드 테스트 완료했습니다. 문제없이 동작합니다."

# 편집기를 열어 코멘트 작성
gh pr comment 123 --editor

# 대화형 모드 (병합 전략 선택)
gh pr merge 123

# 일반 병합 (merge commit 생성)
gh pr merge 123 --merge

# 스쿼시 병합 (모든 커밋을 하나로 합침)
gh pr merge 123 --squash

# 리베이스 병합 (커밋을 대상 브랜치 위에 재적용)
gh pr merge 123 --rebase

# 병합 후 소스 브랜치 삭제
gh pr merge 123 --squash --delete-branch

# 모든 체크가 통과할 때까지 대기 후 자동 병합
gh pr merge 123 --auto --squash

# 병합 커밋 메시지 지정
gh pr merge 123 --merge --subject "feat: user authentication (#123)"

# 병합 커밋 본문 지정
gh pr merge 123 --merge --body "Closes #100, #101"

# 자동 병합 활성화
gh pr merge 123 --auto --squash --delete-branch

# 자동 병합 비활성화
gh pr merge 123 --disable-auto

# 제목 수정
gh pr edit 123 --title "feat: implement user authentication v2"

# 본문 수정
gh pr edit 123 --body "Updated description..."

# 레이블 추가/제거
gh pr edit 123 --add-label "priority:high" --remove-label "priority:low"

# 마일스톤 설정
gh pr edit 123 --milestone "v2.0"

# 프로젝트에 추가
gh pr edit 123 --add-project "Sprint 5"

# 초안 상태 변경
gh pr ready 123  # 초안에서 리뷰 준비 완료로 변경

# 별칭 생성
gh alias set prc 'pr create --draft --assignee @me'
gh alias set prv 'pr view --web'
gh alias set prs 'pr status'
gh alias set prm 'pr merge --squash --delete-branch'

# 별칭 사용
gh prc  # 초안 PR 생성하고 자신 할당
gh prv  # 웹에서 PR 보기
gh prs  # PR 상태 확인
gh prm 123  # 스쿼시 병합 후 브랜치 삭제

# 별칭 목록 확인
gh alias list

# 별칭 삭제
gh alias delete prc

# 특정 필드만 JSON으로 출력
gh pr view 123 --json number,title,state,author,reviews

# jq로 특정 값 추출
gh pr view 123 --json title --jq '.title'

# 열린 PR들의 번호만 추출
gh pr list --json number --jq '.[].number'

# 리뷰 승인된 PR만 필터링
gh pr list --json number,reviews --jq '.[] | select(.reviews | any(.state == "APPROVED")) | .number'

# 특정 템플릿 사용
gh pr create --template bug_fix.md

# .github/workflows/auto-pr.yml 예시
name: Auto PR
on:
  push:
    branches:
      - 'feature/**'

jobs:
  create-pr:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Create PR
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          gh pr create --title "Auto PR: ${GITHUB_REF_NAME}" \
                       --body "Automated PR for feature branch" \
                       --base main

# ~/.config/gh/config.yml 예시
git_protocol: ssh
editor: vim
prompt: enabled
pager: less
aliases:
  prc: pr create --draft --assignee @me
  prv: pr view --web

gh pr view 123 --web
gh pr create --web

gh pr view      # 현재 브랜치의 PR 보기
gh pr edit      # 현재 브랜치의 PR 수정
gh pr merge     # 현재 브랜치의 PR 병합

# macOS
brew upgrade gh

# Linux
sudo apt update && sudo apt upgrade gh