Question 1

gh CLI를 어떻게 설치하나요?

Accepted Answer

macOS에서는 brew install gh, Windows에서는 winget install GitHub.cli 또는 choco install gh로 설치할 수 있습니다. Linux에서는 각 배포판의 패키지 매니저를 사용하거나 공식 릴리즈 페이지에서 직접 다운로드할 수 있습니다.

Question 2

gh pr create 시 기본 브랜치가 아닌 다른 브랜치로 PR을 만들려면?

Accepted Answer

gh pr create --base [target-branch] 옵션을 사용하면 됩니다. 예를 들어 develop 브랜치로 PR을 만들고 싶다면 gh pr create --base develop 명령을 사용하세요.

Question 3

gh로 여러 저장소를 관리하려면?

Accepted Answer

대부분의 gh 명령어에서 -R 또는 --repo 플래그를 사용하여 특정 저장소를 지정할 수 있습니다. 예: gh issue list -R owner/repo. 현재 디렉토리가 Git 저장소가 아니어도 다른 저장소의 이슈나 PR을 관리할 수 있습니다.

Question 4

gh api로 무엇을 할 수 있나요?

Accepted Answer

gh api를 사용하면 GitHub REST API와 GraphQL API를 직접 호출할 수 있습니다. gh 명령어로 직접 지원하지 않는 기능도 API를 통해 사용 가능합니다. 예를 들어 gh api /user로 현재 사용자 정보를 가져오거나, gh api repos/{owner}/{repo}/topics로 토픽을 확인할 수 있습니다.

명령어	설명
`gh auth login`	GitHub 로그인
`gh auth logout`	로그아웃
`gh auth status`	인증 상태 확인
`gh auth refresh`	인증 토큰 갱신
`gh auth switch`	계정 전환

명령어	설명
`gh repo create [name]`	새 저장소 생성
`gh repo clone [repo]`	저장소 복제
`gh repo fork [repo]`	저장소 포크
`gh repo view`	저장소 정보 보기
`gh repo view --web`	브라우저에서 열기
`gh repo list [user]`	저장소 목록
`gh repo delete [repo]`	저장소 삭제
`gh repo rename [new-name]`	저장소 이름 변경

명령어	설명
`gh issue list`	이슈 목록
`gh issue create`	이슈 생성 (대화형)
`gh issue create -t "[title]" -b "[body]"`	이슈 생성 (인라인)
`gh issue view [number]`	이슈 상세 보기
`gh issue close [number]`	이슈 닫기
`gh issue reopen [number]`	이슈 다시 열기
`gh issue edit [number]`	이슈 수정
`gh issue comment [number] -b "[body]"`	이슈에 댓글 추가

명령어	설명
`gh pr list`	PR 목록
`gh pr create`	PR 생성 (대화형)
`gh pr create -t "[title]" -b "[body]"`	PR 생성 (인라인)
`gh pr view [number]`	PR 상세 보기
`gh pr checkout [number]`	PR 브랜치로 전환
`gh pr merge [number]`	PR 병합
`gh pr merge --squash`	Squash 머지
`gh pr merge --rebase`	Rebase 머지
`gh pr close [number]`	PR 닫기
`gh pr review [number]`	PR 리뷰
`gh pr diff [number]`	PR 변경사항 보기

명령어	설명
`gh run list`	워크플로우 실행 목록
`gh run view [run-id]`	실행 상세 보기
`gh run watch [run-id]`	실행 실시간 모니터링
`gh run rerun [run-id]`	워크플로우 재실행
`gh run cancel [run-id]`	실행 취소
`gh run download [run-id]`	아티팩트 다운로드
`gh workflow list`	워크플로우 목록
`gh workflow run [workflow]`	워크플로우 수동 실행
`gh workflow enable [workflow]`	워크플로우 활성화
`gh workflow disable [workflow]`	워크플로우 비활성화

GitHub CLI 치트시트

#인증

#저장소

#이슈

#Pull Request

#GitHub Actions

#릴리즈

#Gist

#검색

#API & 기타

#자주 묻는 질문 (FAQ)

명령어	설명
`gh release list`	릴리즈 목록
`gh release create [tag]`	릴리즈 생성
`gh release create [tag] --generate-notes`	릴리즈 노트 자동 생성
`gh release view [tag]`	릴리즈 상세 보기
`gh release download [tag]`	릴리즈 에셋 다운로드
`gh release upload [tag] [files]`	에셋 업로드
`gh release delete [tag]`	릴리즈 삭제

명령어	설명
`gh gist list`	Gist 목록
`gh gist create [file]`	Gist 생성
`gh gist create --public [file]`	공개 Gist 생성
`gh gist view [id]`	Gist 보기
`gh gist edit [id]`	Gist 수정
`gh gist clone [id]`	Gist 복제
`gh gist delete [id]`	Gist 삭제

명령어	설명
`gh search repos [query]`	저장소 검색
`gh search issues [query]`	이슈 검색
`gh search prs [query]`	PR 검색
`gh search code [query]`	코드 검색
`gh search commits [query]`	커밋 검색

명령어	설명
`gh api [endpoint]`	GitHub API 호출
`gh api graphql -f query="..."`	GraphQL 쿼리
`gh browse`	브라우저에서 현재 저장소 열기
`gh browse [file]`	특정 파일 브라우저에서 열기
`gh alias set [alias] "[command]"`	명령어 별칭 설정
`gh extension list`	확장 목록
`gh extension install [repo]`	확장 설치