제가 써본 최고의 Git Worktree 도구 (Worktrunk)

하이라이트

• WorkTrunk는 Rust로 작성된 CLI 도구이며, 다중 AI 에이전트 작업 시 발생하는 Git 워크트리의 불편함을 해결합니다.

• Mac의 APFS 드라이브에서 제공하는 Copy-on-Write 방식을 활용하여 14GB 규모의 폴더를 복제할 때 용량 추가 없이 20초 만에 처리합니다.

• 첫 Rust 빌드 소요 시간이 기존 68초에서 3~4초 수준으로 단축됩니다.

• 해시 포트 필터 기능이 각 워크트리에 고유한 개발 서버 포트를 할당하여 포트 충돌을 방지합니다.

• wt merge 명령어 하나로 커밋, 스쿼시, main 브랜치 리베이스, 패스트 포워드 및 워크트리 삭제까지 총 6개의 깃 명령어를 한 번에 처리합니다.

타임라인

1. 00:00 - 01:25

   기존 Git 워크트리의 한계와 WorkTrunk의 등장

   동일 저장소에서 여러 에이전트가 동시에 작업할 때 발생하는 파일 충돌 문제를 해결하기 위해 Git 워크트리가 필요하다. 하지만 순정 Git이나 기존 도구들은 생성, 정리, 병합 과정이 번거롭고 현재 상태를 한눈에 보여주는 인터페이스가 부재하다. 이러한 절반의 불편함을 해소하기 위해 WorkTrunk라는 별도의 CLI 도구가 급부상하고 있다.

   • 동일 저장소에서 여러 AI 에이전트를 동시에 구동하면 폴더를 공유하여 테스트 실패 등의 충돌이 발생합니다.
   • 순정 Git 워크트리는 생성과 정리에 다수의 명령어가 필요하고 병합 명령어와 통합 모니터링 화면이 부족합니다.
   • Claude Code의 기본 워크트리 역시 의존성 설치 안내나 병합, 상태 확인 기능이 빠져 있습니다.
2. 01:26 - 03:23

   WorkTrunk의 핵심 기능과 명령어 활용

   세 개의 터미널 창에서 각각 독립된 브랜치와 디렉토리를 격리하여 동시에 실행할 수 있다. wt list 명령어는 로봇 아이콘과 말풍선 등의 시각적 표시를 통해 각 에이전트가 작업 중인지 혹은 응답을 대기 중인지 보여준다. 작업이 완료된 후에는 복잡한 깃 명령어 입력 없이 단일 명령어로 병합과 정리를 마무리할 수 있다.

   • wt switch 명령어를 통해 단 한 줄의 코드로 각 브랜치와 폴더를 생성하고 전환할 수 있습니다.
   • wt list 화면을 통해 모든 워크트리의 브랜치 상태, main 브랜치와의 차이, 에이전트의 작업 및 응답 대기 상태를 한눈에 파악합니다.
   • wt merge 명령어를 실행하면 커밋, 스쿼시, 리베이스, 패스트 포워드, 워크트리 삭제 등 6개의 명령어가 일괄 처리됩니다.
3. 03:24 - 05:27

   아키텍처와 성능 최적화 기능

   새로운 워크트리를 만들 때 무거울 수 있는 모듈과 빌드 캐시 복사 문제를 Copy-on-Write 기술로 해결한다. 맥의 APFS 환경에서는 디스크 블록을 공유하여 대용량 폴더도 즉시 복제되며 빌드 소요 시간을 대폭 줄여준다. 또한 여러 에이전트가 동시에 개발 서버를 띄울 때 포트 번호가 겹치지 않도록 자동 관리하는 기능을 포함한다.

   • WorkTrunk는 Rust로 작성되었으며 셸 함수 설치를 통해 디렉토리 이동을 원활하게 지원합니다.
   • Copy-on-Write 방식을 지원하는 파일 시스템에서는 디스크 용량 소모와 복사 시간을 거의 0에 가깝게 줄여줍니다.
   • 해시 포트 필터가 각 워크트리에 독립적인 개발 서버 포트를 부여해 포트 충돌을 막아줍니다.
4. 05:28 - 07:04

   대안 비교 및 도입 시 유의할 점

   Vibe Kanban 같은 완전한 UI 기반 도구와 비교할 때 터미널 환경에 특화되어 있으나, 아직 1.0 미만 버전이라 변경 로그에 호환성 파괴 내용이 자주 등장한다. 충돌 해결 자체를 자동화해주지는 않으며 파일 시스템 종류에 따라 기능 동작에 차이가 있다. 따라서 대규모 병렬 에이전트를 운용하는 개발자에게 적합한 도구이다.

   • 버전 0.81 수준의 개발 중인 도구이므로 잦은 변경 사항과 설정 변화에 대비해야 합니다.
   • 파일 시스템이 Copy-on-Write를 지원하지 않는 순정 ext4 리눅스 환경에서는 전체 복사가 수행됩니다.
   • 에이전트를 한 번에 하나씩만 사용하는 단일 작업 환경이라면 순정 워크트리로도 충분합니다.