본문으로 건너뛰기

gji가 내 작업에 맞을까요?

리뷰, 기능 개발, 조사, 실험처럼 한 Git 작업을 열어 둔 채 다른 작업을 자주 한다면 gji를 선택하세요. 작업별로 디렉터리를 나누고, 셸에서 하던 작업으로 쉽게 돌아올 수 있게 하는 도구입니다.

하려는 일에 맞는 도구를 고르세요​

필요한 일시작하기 좋은 도구
작업을 열어 둔 채 다른 작업으로 이동gji: 워크트리 생성, 설정 실행, 진입, 돌아오기
Git으로 워크트리 직접 관리git worktree: 연결된 작업 트리 생성, 나열, 제거
터미널 UI에서 Git 작업 수행lazygit: 대화형으로 저장소 검사와 조작
저장소 복제와 루트 위치 찾기ghq: 디스크의 저장소 정리

이 도구들은 함께 사용할 수 있습니다. 예를 들어 ghq로 저장소를 찾고, gji로 작업에 들어간 뒤 그 워크트리 안에서 lazygit을 실행할 수 있습니다. 이 표는 각 도구의 초점을 비교하며, 성능 측정 결과나 모든 기능을 비교한 것은 아닙니다.

Git 워크트리에 gji가 더하는 것​

별도의 작업 트리는 Git이 제공합니다. gji는 워크트리를 사용할 때 반복하는 과정을 이어 줍니다.

  • gji new는 브랜치와 디렉터리를 만들고, 지원하는 의존성 설정을 실행한 뒤 셸을 이동시킵니다.
  • gji pr 1234는 GitHub PR을 별도 작업 디렉터리로 가져옵니다.
  • gji go는 등록된 여러 저장소에 걸쳐 열려 있는 작업을 찾습니다.
  • gji back은 방금 떠나온 워크트리로 돌아갑니다.
  • gji done과 gji clean은 상태 검사와 확인을 거쳐 끝난 워크트리를 제거합니다.

셸 통합을 불러오면 다음과 같이 작업을 전환했다가 돌아올 수 있습니다.

# Your feature is already open in its own worktree.
gji pr 1234
# Inspect and test the PR here.
gji back
# Continue your feature with its changes still in place.

저장소의 실제 PR 번호를 사용하세요. 새 워크트리는 의존성 설치가 필요할 수 있으며, 기존 워크트리는 자체 설치 상태를 유지합니다.

기존 도구만으로 충분한 경우​

한 번에 한 브랜치에서 작업하고 두 번째 작업 사본이 거의 필요 없다면 CLI를 추가해도 큰 도움이 되지 않을 수 있습니다. 설정과 이동을 잘 처리하는 경로 구조와 스크립트가 이미 있다면 git worktree만으로도 충분할 수 있습니다.

사용 전에 알아둘 비용과 제약​

  • 워크트리마다 파일과 의존성을 위한 디스크 공간이 필요합니다. 첫 설정에는 시간이 걸립니다.
  • 워크트리는 저장소 이력과 참조를 공유합니다. 서비스, 포트, 외부 데이터를 격리하지 않습니다.
  • 현재 셸을 자동으로 이동시키려면 셸 통합이 필요합니다.
  • 이동할 때 gji는 미커밋 변경 사항을 옮기지 않습니다. 그 작업은 new --take로 명시적으로 수행합니다.
  • 정리하면 브랜치와 미커밋 파일이 삭제될 수 있습니다. 실행 취소는 기록된 Git 및 워크트리 상태를 복원할 뿐, 미커밋 파일은 복구하지 않습니다.

이런 특성이 내 작업에 맞는다면 빠른 시작을 따라 해 보세요. 처음에는 명령을 많이 외우기보다, 열어 둔 작업으로 다시 돌아와 보세요.