GitHub CLI (`gh`) 완벽 가이드

GitHub CLI (gh) 완벽 가이드

GitHub CLI(gh)는 터미널에서 GitHub과 상호작용할 수 있도록 도와주는 강력한 도구입니다. 이 글에서는 gh의 설치부터 주요 기능까지 자세히 다뤄보겠습니다.

1. GitHub CLI 설치

macOS (Homebrew)

brew install gh

Windows (Scoop or Chocolatey)

scoop install gh  # 또는
choco install gh

Linux (APT, RPM, Pacman)

# Debian/Ubuntu
sudo apt install gh
 
# Fedora
sudo dnf install gh
 
# Arch Linux
sudo pacman -S github-cli

설치 후 정상적으로 동작하는지 확인합니다:

gh --version

2. GitHub CLI 인증 (로그인)

GitHub API를 사용하려면 먼저 로그인해야 합니다.

gh auth login

GitHub 계정을 선택하고, HTTPS 또는 SSH 인증 방식을 결정합니다.

• HTTPS 인증: GitHub Personal Access Token (PAT)을 사용해야 합니다.

• SSH 인증: ssh-keygen으로 생성한 SSH 키를 등록하여 사용합니다.

로그인 후, 인증 상태를 확인할 수 있습니다:

gh auth status

3. 기본적인 GitHub 명령어

GitHub CLI를 사용하면 웹 브라우저를 열지 않고도 GitHub에서 다양한 작업을 수행할 수 있습니다.

3.1 저장소 관리

새 저장소 생성

gh repo create <REPO_NAME> --public   # 공개 저장소

gh repo create <REPO_NAME> --private  # 비공개 저장소

기존 저장소 클론

gh repo clone <OWNER/REPO>

원격 저장소 URL 확인

gh repo view --web

3.2 이슈 관리

이슈 목록 조회

gh issue list

새로운 이슈 생성

gh issue create --title "버그 발생" --body "로그인이 되지 않습니다."

특정 이슈 보기

gh issue view <ISSUE_NUMBER>

이슈 닫기

gh issue close <ISSUE_NUMBER>

3.3 PR(Pull Request) 관리

현재 브랜치에서 PR 생성

gh pr create --title "새로운 기능 추가" --body "자세한 설명..."

PR 목록 보기

gh pr list

특정 PR 정보 확인

gh pr view <PR_NUMBER>

PR 승인 및 병합

gh pr merge <PR_NUMBER> --merge

4. 워크플로우 자동화

GitHub Actions을 gh로 직접 실행하고 모니터링할 수도 있습니다.

GitHub Actions 실행 상태 확인

gh run list

특정 실행(job) 상태 보기

gh run view <RUN_ID>

워크플로우 다시 실행

gh run rerun <RUN_ID>

5. 기타 유용한 명령어

GitHub Discussions 참여

gh discussion list -R <OWNER/REPO>

사용자 정보 조회

gh user view <USERNAME>

웹 브라우저에서 빠르게 저장소 열기

gh browse

6. 결론

GitHub CLI(gh)는 터미널에서 GitHub과의 상호작용을 훨씬 더 편리하게 만들어 줍니다. 이슈 관리, PR 처리, Actions 실행 등 다양한 작업을 터미널에서 간편하게 수행할 수 있으므로 적극적으로 활용해 보세요!

---

참고 자료

• GitHub CLI 공식 문서