| name | gh-setup |
| description | GitHub CLI(`gh`)가 없거나 로그인되어 있지 않을 때 Windows·WSL·Linux·macOS 를 판별해 설치 경로를 정하고, 권한이 필요 없는 명령은 자동 실행하고 관리자 권한이 필요한 명령은 그대로 복사해 쓸 수 있게 안내한 뒤 `gh auth login` 까지 끌고 갑니다. 설정은 `~/.issue/settings.json` 에서 관리합니다. `/gh-setup`, "gh 설치", "gh 로그인", "GitHub CLI 설정" 요청과 gh 가 필요한 다른 스킬의 전제 확인 실패 시 사용합니다. |
`gh` 를 쓰는 모든 흐름의 진입 장벽을 없앤다.
OS·터미널·다운로드 도구·패키지 매니저를 감지해 설정 파일에 남기고,
그 조합에 맞는 설치 명령을 만들어 자동 실행하거나 정확히 안내한다.
마지막으로 로그인까지 확인한다.
`install` / `login` / `status` 같은 원하는 단계. 생략하면 전체 흐름
없음. 이 스킬이 전제를 만드는 쪽이다
references/settings.md — settings.json 스키마와 선호도 편집
references/install-matrix.md
references/auth-login.md
sudo 나 관리자 권한이 필요한 명령을 대신 실행하지 않는다. 비밀번호 프롬프트에서 멈춘다.
권한이 필요 없는 패키지 매니저 설치만 자동 실행한다.
`gh auth login` 은 대화형이므로 사용자가 직접 실행하게 한다.
토큰 값을 출력하거나 파일로 저장하지 않는다.
사용자가 설정 파일에 넣어 둔 선호 순서를 재감지로 덮어쓰지 않는다.
`gh` 준비가 끝나면 원래 하려던 작업(`issue-create` / `issue-start` / `issue-end` 등)으로 돌아간다.
전체 흐름
flowchart TD
A[/"gh 필요 · /gh-setup"/] --> B[detect: OS·터미널·다운로더·패키지매니저]
B --> C[settings.json 생성 또는 갱신]
C --> D[status: gh 설치·인증 확인]
D -->|설치됨 + 로그인됨| Z[준비 완료 · 원래 작업으로 복귀]
D -->|설치 안 됨| E[plan: OS별 설치 명령 생성]
E --> F{권한 필요?}
F -- 불필요 --> G[install: 자동 실행]
F -- 필요 --> H[사용자가 실행할 명령 제시]
H --> H1[사용자 실행 대기]
G --> I[status 재확인]
H1 --> I
I -->|실패| E
I -->|설치 확인| J{로그인됨?}
D -->|설치됨 + 로그인 안 됨| J
J -- 예 --> Z
J -- 아니오 --> K[환경별 login 명령 안내]
K --> K1[사용자 실행 대기] --> L[gh auth status 확인] --> Z
스크립트 경로
아래 중 존재하는 첫 번째 경로를 <skill> 로 쓴다.
.claude/skills/gh-setup # 현재 프로젝트 (Claude Code)
.codex/skills/gh-setup # 현재 프로젝트 (Codex)
~/.claude/skills/gh-setup # 홈 설치
~/.codex/skills/gh-setup # 홈 설치
런타임 라우팅
항상 라우터를 부른다. 라우터가 node → python 순으로 찾아 넘기고, 둘 다 없으면 자체 폴백으로 처리한다.
sh <skill>/scripts/gh-env.sh <서브커맨드>
powershell -ExecutionPolicy Bypass -File <skill>/scripts/gh-env.ps1 <서브커맨드>
출력의 RUNTIME= 으로 어느 구현이 돌았는지 알 수 있다 (node / python / sh / ps1).
폴백(sh / ps1)은 감지와 안내까지만 한다. install 자동 실행과 config set 은 지원하지 않는다.
서브커맨드
detect 감지 후 ~/.issue/settings.json 생성·갱신
status gh 설치·인증 확인 후 settings.gh 갱신
plan OS별 설치 명령 목록 ([auto] / [user] / [guide] 표시)
install [--dry-run] [auto] 표시된 명령만 실행
login 환경에 맞는 로그인 방법 안내
config get [key] 설정 읽기
config set <k> <v> terminals / downloaders 순서 변경 (쉼표 구분)
실행 순서
1단계 — 감지와 상태 확인
sh <skill>/scripts/gh-env.sh detect
sh <skill>/scripts/gh-env.sh status
GH_INSTALLED=1 이고 GH_AUTHENTICATED=1 이면 여기서 끝이다. 바로 원래 작업으로 돌아간다.
2단계 — 설치
sh <skill>/scripts/gh-env.sh plan
sh <skill>/scripts/gh-env.sh install
install 은 [auto] 단계만 실행한다. [user] 로 남은 명령은 사용자에게 이렇게 전달한다.
아래 명령을 프롬프트에 그대로 붙여 실행해 주세요 (`!` 로 시작하면 이 세션에서 바로 돌아갑니다).
! sudo apt update && sudo apt install gh -y
세부 매트릭스는 references/install-matrix.md.
3단계 — 로그인
sh <skill>/scripts/gh-env.sh login
LOGIN_REQUIRED=1 이면 안내된 명령을 사용자가 실행할 때까지 기다린다. 세부는 references/auth-login.md.
4단계 — 확인과 복귀
sh <skill>/scripts/gh-env.sh status
GH_INSTALLED=1, GH_AUTHENTICATED=1 을 확인한 뒤 원래 작업을 이어간다.
마무리 보고
플랫폼 <os> / <arch> (<family>)
터미널 <선호 0번>
gh <버전> · 로그인 <계정>
설정 ~/.issue/settings.json
다음 <원래 하려던 작업>
