본문으로 건너뛰기

명령어 참고

하려는 일에 맞는 항목부터 살펴보세요. 명령의 전체 옵션 목록은 gji <command> --help로 확인할 수 있습니다. gji를 처음 써 본다면 빠른 시작을 먼저 따라 해 보세요.

시작과 검토​

명령결과
gji new [branch]브랜치와 연결된 워크트리 생성. 브랜치를 생략하면 대화형으로 진행
gji pr <ref>GitHub 풀 리퀘스트를 전용 워크트리로 가져오기. 번호, #number, URL 지원
gji pr open [branch|#N]현재 또는 지정한 워크트리의 PR 웹 페이지 열기
gji pr open --select연결된 워크트리에서 PR을 선택한 뒤 웹 페이지 열기

만들 때 사용할 수 있는 옵션​

옵션효과
--open, --editor <cli>생성한 워크트리를 에디터로 열기. --editor에는 --open이 필요
--task <description>새 워크트리의 용도 기록
--from-current메인 워크트리 대신 현재 워크트리의 HEAD에서 새 브랜치 시작
--detached브랜치 없이 임시 작업 공간 생성. --from-current와 함께 사용 불가
--take현재 미커밋 변경 사항을 새 워크트리로 이동
--take --copy변경 사항을 복사하고 원본에도 유지
--branch-only현재 워크트리에 브랜치 생성. 변경 사항이 없어야 하며 새 디렉터리는 만들지 않음
--no-fetch생성 전 원격 기본 브랜치 갱신 생략
--no-install이 워크트리의 자동 의존성 설정 생략
--dry-runGit 명령 실행이나 파일 쓰기 없이 계획 확인
--force기존 대상 워크트리 경로를 제거한 뒤 다시 생성. 교체 전에 검토 필요
--json성공 또는 오류를 구조화된 출력으로 내보내기

이 옵션들은 new에 대한 설명입니다. pr은 --no-install, --dry-run, --json을 지원합니다. 프로젝트별 설정은 기본 의존성 어댑터 실행 후에 이어집니다. 설정을 참고하세요.

gji new feature/search --open --editor cursor
gji new feature/search-tests --from-current
gji pr 1234 --dry-run

--branch-only는 설정된 기본 브랜치를 갱신하고 의존성 설정 없이 현재 위치에 브랜치를 만듭니다. 로컬 기본 브랜치를 사용하려면 --no-fetch를 사용하세요. 떠나는 작업을 열어 두어야 한다면 별도 워크트리를 선택하세요.

명령결과
gji go [branch]기존 워크트리로 진입하거나 브랜치, 원격 브랜치, PR을 찾아 워크트리를 준비한 뒤 이동
gji go repo/branch등록된 여러 저장소에서 원하는 목적지 지정
gji go --root 또는 gji root메인 저장소 체크아웃으로 돌아가기
gji back [n] 또는 gji go -이전에 방문한 워크트리로 돌아가기. back n은 이력을 더 거슬러 이동
gji history [--json]방문 이력 표시
gji open [branch]현재 또는 지정한 워크트리를 에디터로 열기
gji open --select대화형으로 워크트리와 에디터 선택

목적지가 없으면 go는 현재 저장소의 선택기를 엽니다. 등록된 모든 저장소를 보려면 Tab, 브랜치, 경로, PR, 작업 설명을 검색하려면 **/**를 누르세요.

브랜치를 지정하면 현재 저장소부터 찾습니다. 이후에는 등록된 다른 저장소, 기존 로컬 브랜치, 가져온 원격 브랜치, PR 참조 순으로 확인합니다. go --json은 기존 목적지만 확인하며, 새로 가져오거나 만들지 않습니다.

gji go feature/payments
gji go api/main
gji back 2
gji open --editor cursor --save
gji open feature/payments --workspace

open --save는 에디터 CLI를 기억합니다. --workspace는 VS Code, Cursor, Windsurf용 .code-workspace 파일을 생성합니다. go --quiet는 작업 정보 카드를 숨깁니다. 이동 명령은 셸 통합을 불러온 경우에만 현재 셸의 디렉터리를 바꿉니다.

작업 상태를 확인하고 설명 남기기​

명령결과
gji [--json]현재 작업과 추천 목적지, 확인할 워크트리를 한곳에 보여 주는 저장소 허브 열기
gji status [--json]저장소와 워크트리 상태 및 앞선 커밋과 뒤처진 커밋 수 확인
gji ls [--compact] [--json]워크트리 나열. 간략 모드에서는 브랜치와 경로 표시
gji task [description] [--clear] [--json]현재 워크트리의 작업 설명 읽기, 설정, 지우기
gji doctor [--json]셸, Git, 설정, 저장소 등록 상태 진단

gji doctor --fix로 더 이상 존재하지 않는 저장소를 등록 목록에서 제거할지 확인하세요. Git이나 셸 설정을 자동으로 복구하지는 않습니다. --yes를 사용하면 확인 없이 해당 수정을 적용합니다.

유지 관리​

명령결과
gji sync [--all] [--json]하나 또는 모든 워크트리에서 원격 변경 사항을 가져와 기본 브랜치 위로 리베이스
gji done [branch] [--keep-branch] [--force] [--json]완료된 연결 워크트리와, 유지하지 않은 경우 그 브랜치 제거
gji clean [--stale] [--path <pattern>] [--dry-run] [--force] [--json]여러 연결 워크트리를 선택해 제거
gji undo [id] [--list] [--json]기존 작업을 덮어쓰지 않고 저널에 기록된 정리 상태 복원
gji sync-files [list|add|remove] [paths...] [--json]메인 워크트리에서 이후 워크트리로 복사할 파일 관리
gji run-hook <hook>현재 워크트리에서 설정된 수명 주기 훅 실행. trigger-hook은 별칭

sync에서 리베이스 충돌 해결이 필요할 수 있습니다. done과 clean은 브랜치를 삭제할 수 있습니다. --force는 미커밋 파일을 버리고 병합되지 않은 브랜치를 삭제할 수 있으며, 실행 취소로 해당 파일을 복구할 수 없습니다. 제거를 자동화하기 전에 동기화와 정리를 읽으세요.

gji clean --stale --dry-run
gji done feature/search --keep-branch
gji undo --list
gji sync-files add .env.local
gji run-hook afterCreate

--stale은 업스트림이 사라졌고 변경 사항이 기본 브랜치에 이미 병합된, 변경 사항 없는 워크트리를 선택합니다. 여러 위치 중 하나와 일치시키려면 --path를 반복하세요. 경로 필터는 등록된 모든 저장소를 검색합니다. 경로 필터를 참고하세요.

설정과 기본값​

명령결과
gji init [shell] [--write]안내에 따라 설정하거나 특정 셸 래퍼 출력 또는 설치
gji completion [shell]셸 자동 완성 출력
gji config get [key]전역 기본값 또는 특정 값 읽기
gji config set <key> <value>전역 기본값 저장
gji config unset <key>전역 기본값 제거

설정 방법은 설치, 설정, 훅을 참고하세요.

스크립트용 경로와 JSON​

목적지만 필요하다면 go, back, root에 --print를 사용하세요.

feature_path=$(gji go --print feature/payments)

허브, new, pr, go, status, ls, task, history, sync, sync-files, clean, done, undo, doctor에서 --json을 사용할 수 있습니다. 이동 JSON에는 repository.name과 정규화된 repository.root가 포함됩니다.

gji --json
gji go feature/payments --json
gji new feature/search --json

JSON 출력이라고 해서 읽기 전용으로 동작하는 것은 아닙니다. 생성 명령은 생략하지 않는 한 의존성 설정을 실행합니다. 지원하는 명령에서는 --dry-run으로 계획을 확인하세요. 비대화형 정리에서는 제거를 위해 --force가 필요하므로, 먼저 --dry-run으로 후보를 검토하세요.