AI 에이전트 여러 개를 동시에 돌리면서도 각자의 작업 공간이 뒤섞이지 않게 해주는 도구
Claude Code나 Codex 같은 AI 에이전트를 5~10개 이상 동시에 실행할 때, 각자가 독립된 디렉터리에서 코드를 수정하도록 돕습니다. Git의 워크트리 기능을 더 쉽게 사용할 수 있게 만들어주는 명령줄 도구입니다. 에이전트들이 서로의 변경사항을 덮어쓰지 않고 각자의 브랜치에서 작업할 수 있는 환경을 자동으로 만들어줍니다.
워크트리 관리를 브랜치처럼 쉽게
Git 워크트리는 여러 에이전트가 동시에 작업할 때 각자에게 독립된 디렉터리를 제공하지만, 기존 명령어는 사용법이 복잡합니다. 새 워크트리를 만들 때 브랜치 이름을 세 번이나 입력해야 하는 번거로움이 있었습니다. 이 도구는 워크트리를 브랜치 이름으로만 지정하면 경로를 자동으로 계산해줍니다. wt switch feat 한 줄로 워크트리를 만들고 해당 디렉터리로 이동할 수 있습니다. 에이전트를 실행하는 명령어도 함께 붙여 실행할 수 있어, 세팅 과정이 크게 줄어듭니다.
병렬 작업 자동화 기능
여러 워크트리를 관리할 때 필요한 반복적인 작업을 자동화하는 기능이 포함되어 있습니다. 워크트리 생성 시 특정 명령을 실행하는 훅을 설정할 수 있습니다. 커밋 메시지를 AI가 자동으로 생성해 주는 기능도 지원합니다. 병합 워크플로우를 하나의 명령으로 처리해, 스퀴시, 리베이스, 병합, 정리 과정을 한 번에 수행합니다. 또한 CI 상태와 PR 정보를 실시간으로 보여주는 인터랙티브 선택기를 제공합니다. 빌드 캐시를 공유해 여러 워크트리에서 동일한 의존성을 다시 빌드하지 않도록 합니다.
설치 및 초기 설정
macOS와 Linux에서는 Homebrew를 통해 설치할 수 있습니다. Windows에서는 Winget을 사용하며, wt 명령이 Windows Terminal과 충돌할 수 있어 git-wt로 설치하거나 별칭을 변경해야 합니다. Rust로 작성되어 있어 Cargo를 통한 설치도 가능합니다. 셸 통합이 없으면 디렉터리 변경 명령이 정상적으로 작동하지 않을 수 있으니 반드시 설정해야 합니다.
적합한 사용 환경
Claude Code나 Codex 같은 AI 에이전트를 여러 개 동시에 실행하는 개발자에게 적합합니다. Git 워크트리를 이미 사용 중이지만 명령어가 복잡하다고 느끼는 사람에게도 유용합니다. 병렬로 여러 기능을 개발하거나 버그를 수정하는 워크플로우를 구축하려는 팀에 도움이 됩니다. APFS, btrfs, XFS 파일 시스템을 사용하는 환경에서는 빌드 캐시 공유 기능이 특히 효과적입니다. Git 기반 프로젝트라면 언어에 관계없이 사용할 수 있습니다.
