coderabbitai/git-worktree-runner

어떤 프로젝트인가요?

핵심 기능

• 01짧은 명령으로 브랜치 이름을 기준으로 worktree를 생성, 나열, 이름 변경 및 제거
• 02`git gtr pr`로 pull request를 worktree에 체크아웃
• 03include 및 exclude 패턴을 사용해 새 worktree에 환경 파일과 설정 파일 복사
• 04의존성 설치와 같은 생성 후 hook 실행
• 05지원되는 에디터에서 worktree를 열거나 기본 어댑터로 AI 코딩 도구 실행
• 06병합되거나 닫힌 PR 또는 MR의 worktree 정리

활용 사례

• 현재 기능 개발을 중단하지 않고 팀원의 pull request 검토
• 각자 별도 브랜치에서 여러 AI 코딩 에이전트를 병렬로 실행
• 테스트나 빌드를 위한 깨끗한 main worktree 유지
• 팀 전체에서 환경 파일 및 의존성 설치와 같은 브랜치별 설정 표준화

빠른 시작

1. 1

   Homebrew로 설치(macOS)

   brew tap coderabbitai/tap && brew install git-gtr
2. 2

   또는 저장소를 clone

   git clone https://github.com/coderabbitai/git-worktree-runner.git
3. 3

   체크아웃 디렉터리에서 설치 프로그램 실행

   ./install.sh
4. 4

   브랜치용 worktree 만들기

   git gtr new my-feature

사용 전 알아둘 점

• !Bash 3.2 이상과 Git 2.17 이상이 필요합니다. Windows는 Git Bash를 통해서만 지원됩니다.
• !Windows에서는 bin/git-gtr만 복사하면 작동하지 않으므로 체크아웃 전체를 그대로 유지해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

git-worktree-runner은(는) 무엇인가요?

브랜치별 worktree를 만들고 설정하고 제거하며, 에디터와 AI 에이전트를 실행할 수 있는 Git worktree 래퍼 Bash CLI입니다. gtr(Git Worktree Runner)는 Git worktree를 더 쉽게 사용할 수 있게 해 주는 명령줄 도구입니다. worktree를 사용하면 같은 저장소의 여러 브랜치를 각기 다른 폴더에 동시에 체크아웃할 수 있어, 변경 사항을 stash하거나 브랜치를 전환하지 않고도 기능 개발, pull request 검토, main 브랜치 테스트를 할 수 있습니다. gtr은 `git gtr new`, `git gtr pr 123`, `git gtr rm`처럼 짧은 명령으로 기본 git worktree 명령을 사용할 수 있게 해 줍니다.

git-worktree-runner은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

git-worktree-runner은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

git-worktree-runner은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. git-worktree-runner의 마지막 커밋은 2026년 11월 6일입니다.

git-worktree-runner은(는) 어디에 사용할 수 있나요?

현재 기능 개발을 중단하지 않고 팀원의 pull request 검토 각자 별도 브랜치에서 여러 AI 코딩 에이전트를 병렬로 실행 테스트나 빌드를 위한 깨끗한 main worktree 유지 팀 전체에서 환경 파일 및 의존성 설치와 같은 브랜치별 설정 표준화

git-worktree-runner는 어떻게 설치하나요?

Homebrew로 설치(macOS): brew tap coderabbitai/tap && brew install git-gtr 또는 저장소를 clone: git clone https://github.com/coderabbitai/git-worktree-runner.git 체크아웃 디렉터리에서 설치 프로그램 실행: ./install.sh 브랜치용 worktree 만들기: git gtr new my-feature

git-worktree-runner은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/coderabbitai/git-worktree-runner