max-sixty/worktrunk는 AI 에이전트를 병렬로 돌리기 위해 만든 git worktree 관리 CLI입니다. MIT와 Apache-2.0 중 골라 쓰는 이중 라이선스이고, 2026년 11월 7일 기준 깃허브 스타 11,807개입니다. 문서는 worktrunk.dev에 있습니다.
왜 worktree인가
Claude Code나 Codex는 감독 없이 긴 작업을 하니 5~10개를 동시에 돌릴 수도 있습니다. 그런데 한 폴더에서 여러 에이전트가 일하면 서로 같은 파일을 고치다 꼬입니다. git의 worktree는 브랜치마다 작업 폴더를 따로 만들어 이 문제를 없앱니다.
문제는 명령이 번거롭다는 것입니다. 새 worktree 하나를 여는 데도 브랜치 이름을 세 번 칩니다.
git worktree add -b feat ../repo.feat
cd ../repo.feat주요 명령 4개
| 하려는 일 | worktrunk | git만 쓰면 |
|---|---|---|
| worktree 옮겨 가기 | wt switch feat | cd ../repo.feat |
| 만들고 Claude 켜기 | wt switch -c -x claude feat | git worktree add -b feat ../repo.feat && cd ../repo.feat && claude |
| 정리 | wt remove | cd ../repo && git worktree remove ../repo.feat && git branch -d feat |
| 상태와 함께 목록 | wt list | git worktree list(경로만) |
worktree는 브랜치 이름으로 부르고, 폴더 경로는 설정한 틀에 따라 정해집니다.
설치
brew install worktrunk && wt config shell install # macOS·Linux
cargo install worktrunk && wt config shell install # Cargowt config shell install은 명령이 폴더를 옮길 수 있게 셸에 연결합니다. Windows는 winget install max-sixty.worktrunk로 깔고, Windows Terminal의 wt와 겹치지 않게 git-wt라는 이름으로 씁니다.
병렬 작업 흐름
wt switch -c -x claude auth # 첫 번째 에이전트: 로그인 기능
wt switch -c -x claude billing # 두 번째 에이전트: 결제 기능
wt list # 폴더별 바뀐 줄, main 대비 커밋, 원격 상태
wt step commit # AI가 쓴 커밋 메시지로 커밋
wt remove # PR이 합쳐지면 정리wt list --full은 브랜치마다 CI 상태와 AI 요약까지 보여 줍니다.
편의 기능
- 훅: 만들 때, 합치기 전후 등에 명령 실행
- 빌드 캐시 공유: worktree 열 개가
node_modules,target/을 새로 빌드하거나 복사하지 않고 공유(APFS, btrfs, XFS) - PR 바로 열기:
wt switch pr:123 - worktree마다 개발 서버 포트:
hash_port필터로 겹치지 않는 포트 - 한 번에 합치기: squash, rebase, merge, 정리를 한 명령으로
오늘 할 일
brew로 설치하고, 다음 작업 두 개를 wt switch -c -x claude로 각자 다른 폴더에서 동시에 맡겨 보세요. 끝나면 wt list로 둘의 진행을 한눈에 봅니다.
쇼츠로 보기
이 글은 비치콤버스 쇼츠 No.54의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/54.