← 블로그로
Ai약 11 분 읽기

에이전트 열 개를 동시에 돌리면 Git 저장소가 먼저 깨진다

게시일 2026년 11월 7일
에이전트 열 개를 동시에 돌리면 Git 저장소가 먼저 깨진다

코딩 에이전트에 대한 홍보 문구는 올해 내내 같았습니다. 무인으로 돌아가니 동시에 여러 개를 돌리라는 것입니다. 다섯 개, 열 개, 더 많이. 하나는 인증 리팩터링에, 하나는 불안정한 테스트에, 하나는 아무도 건드리고 싶지 않은 마이그레이션에.

도구는 대체로 버팁니다. 그러고 나서 실제로 해보면, 깨지는 것이 작업 디렉터리라는 걸 알게 됩니다.

한 체크아웃에서 에이전트 두 개를 돌리면 1분 안에 서로의 파일을 덮어씁니다. 해법은 2015년부터 git에 있었습니다. worktree입니다. 각 브랜치에 자기 디렉터리를 주면서 객체 데이터베이스 하나를 공유합니다. git은 이걸 할 수 있습니다. 그걸 하기 위한 git의 인터페이스가 형편없어서 대부분은 쓰지 않을 뿐입니다.

Worktrunk는 그 인터페이스를 고치는 Rust CLI입니다. 스타 11,900개, 그중 약 2,200개가 지난주에 붙었습니다. 라이선스는 MIT 또는 Apache-2.0으로, 선호하는 쪽을 쓰면 됩니다.

세 번 타이핑하는 문제

git에서 worktree를 만들려면 브랜치 이름을 세 번 입력해야 합니다.

git worktree add -b feat ../repo.feat cd ../repo.feat

셋 중 둘은 중복입니다. 명령이 경로와 브랜치를 요구하는데 경로는 거의 항상 브랜치에서 유도할 수 있기 때문에 이렇게 되어 있습니다. 사소한 불편처럼 들립니다. worktree가 기본값이 아니라 강한 의견을 가진 사람들의 기법으로 남은 이유가 이것입니다.

Worktrunk는 worktree를 브랜치 이름으로 다루고, 경로는 설정 가능한 템플릿에서 계산합니다. 브랜치를 받는 모든 명령은 그 브랜치를 담은 worktree의 경로도 받습니다. 그래서 어색한 세 줄 춤은 이렇게 됩니다.

wt switch -c -x claude feat

브랜치를 만들고, 그 worktree를 만들고, 그 안에서 Claude를 시작합니다. 어디에 있든 상관없이. -x 플래그는 전환 후 명령을 실행합니다. 구분자 뒤에 덧붙인 것은 그 명령으로 전달되며, 이렇게 에이전트에게 첫 지시를 넘깁니다.

wt switch -x claude -c feature-auth

셸 하나에서 이걸 세 번 치면 브랜치 셋에 에이전트 셋이 생깁니다. 서로 격리되어 있고, 사이에 조율은 없습니다.

설치

macOS나 Linux에서는 Homebrew입니다. brew install worktrunk && wt config shell install. Cargo, pacman, conda-forge, pixi 모두 됩니다. Windows에서는 winget install max-sixty.worktrunk에 이어 git-wt config shell install입니다.

Windows 이야기는 반복할 가치가 있습니다. 누군가는 반드시 걸리기 때문입니다. wt는 이미 Windows Terminal이 쓰고 있어서 Winget은 충돌을 피하려고 도구를 git-wt로 설치합니다. 앱 실행 별칭에서 Windows Terminal 별칭을 끄고 wt를 그대로 쓸 수도 있습니다.

config shell install 단계는 선택이 아닙니다. 명령이 현재 디렉터리를 바꿀 수 있게 하는 셸 훅을 설치하며, 이것이 wt switch의 전부입니다. 건너뛰면 모든 명령이 아무것도 하지 않는 것처럼 보입니다.

중요한 명령들

네 개면 워크플로 대부분을 덮습니다.

wt switch 는 이동합니다. wt list는 모든 worktree를 상태 표시와 함께 보여줍니다. @는 현재 위치, +는 스테이징된 변경, ↑1은 main보다 한 커밋 앞섬, ⇡는 푸시되지 않은 커밋입니다. 이 출력만으로도 git worktree list보다 낫습니다. 그쪽은 경로만 주고 그 외엔 아무것도 주지 않습니다.

wt remove는 정리합니다. worktree와 브랜치를 함께 삭제하는데, git에서는 명령 두 개이고 틀릴 곳이 한 군데입니다.

wt merge main이 흥미로운 쪽입니다. 현재 브랜치를 squash하고, main 위로 rebase하고, fast-forward하고, worktree를 제거합니다. 한 단계로. 병렬 브랜치 셋에서 같은 충돌을 세 번 해결해 본 적이 있다면 왜 이게 있는지 알 것입니다. 병렬화는 병합 문제를 증폭시키고, 병합 문제는 원래 이 일에서 가장 즐겁지 않은 부분이었습니다.

wt switch pr:123도 있습니다. 풀 리퀘스트 뒤의 브랜치로 곧장 이동합니다. 작은 기능이고, 그에 비해 과하게 좋은 편의성입니다.

저장 공간은 아무도 경고하지 않는 부분

worktree 열 개면 node_modules 열 벌, target/ 열 벌입니다. 노트북에서는 수백 기가바이트이고, 각각에서 첫 cargo build에 4분이 걸립니다.

Worktrunk는 이를 copy-on-write 빌드 캐시로 처리합니다. 이를 지원하는 파일 시스템, macOS의 APFS, Linux의 reflink 지원 btrfs와 XFS에서 worktree는 빌드 디렉터리를 공유하고 파일이 바뀔 때만 갈라집니다. 첫 빌드가 비용을 치르고, 나머지 아홉은 빌려 씁니다.

이런 기능은 작성자가 실제로 이 도구를 무엇에 쓰는지 드러냅니다. 마케팅을 위해 worktree 관리자에 공유 빌드 캐시를 넣는 사람은 없습니다. 디스크가 꽉 찬 게 네 번째가 된 뒤에 넣습니다.

관련된 세부가 hash_port입니다. 각 worktree에 고유한 포트를 주는 템플릿 필터입니다. worktree 열 개, 개발 서버 열 개, 포트 충돌 없음, 수동 기록 없음. 의존성을 설치하고 서버를 띄우는 post-start 훅과 결합하면, 새 worktree는 에이전트가 시작하는 순간 완전히 작동합니다.

훅은 날카로운 쪽

훅은 정해진 시점에 셸 명령을 자동 실행합니다. worktree가 시작된 뒤, 병합 전, 병합 후. post-start 훅은 환경 설정을 공짜로 얻는 방법입니다.

동시에 git 작업으로 촉발되는 임의 코드 실행이기도 합니다. 저장소는 wt switch에서 무언가를 실행하는 설정을 함께 배포할 수 있고, 당신이 그것을 clone해서 브랜치로 전환하면 그것이 실행됩니다. npm install이 postinstall 스크립트를 실행하는 것과 같은 종류의 위험이고, 같은 대우를 받아야 합니다. 저장소를 신뢰하기 전에 설정을 읽으십시오.

이에 대한 도구 자신의 답은 훅이 당신이 통제하는 설정에 선언된다는 것입니다. 그것으로 충분한지는 위협 모델에 달려 있고, 낯선 저장소를 clone하는 사람이라면 한번쯤 생각해 볼 가치가 있습니다.

고치지 않는 것

worktree는 .git 디렉터리 하나를 공유하므로 브랜치 참조, stash, 설정도 공유합니다. 두 에이전트가 같은 브랜치를 체크아웃할 수 없습니다. 한 worktree에서의 git rebase는 다른 worktree가 앉아 있는 히스토리를 바꿉니다. reflog 항목은 사후 분석을 더 어렵게 만드는 방식으로 뒤섞입니다.

Worktrunk는 흔한 경우를 쾌적하게 만들 뿐 근본 모델을 바꾸지 않습니다. 에이전트에게 진짜 독립적인 저장소가 필요하다면 별도 clone이 필요하고, 그러면 worktree를 싸게 만드는 공유 객체 저장소를 잃습니다.

도구가 건드리지 않는 조율 문제도 있습니다. 브랜치 열 개의 에이전트 열 개는 같은 파일 세 개를 건드리는 풀 리퀘스트 열 개를 만들고, 아무리 worktree를 관리해도 그것들이 깔끔하게 병합되지는 않습니다. 병렬화에서 가치를 얻는 팀은 에이전트를 가장 많이 돌리는 팀이 아니라 겹치지 않는 영역을 배정하는 팀인 것 같습니다.

이런 도구가 주목받는 이유

에이전트 프레임워크는 발표를 얻습니다. 에이전트를 쓸 만하게 만드는 유틸리티가 스타를 얻습니다.

그 패턴은 올해 내내 반복되었습니다. 메모리 계층, 권한 모드, 샌드박스, worktree 관리자. 각각은 모델이 일을 할 만큼 좋아졌고, 주변 환경은 지치지 않고 질문하지 않으며 잘못된 디렉터리에서 40분 동안 기꺼이 달리는 노동자를 위해 설계된 적이 없기 때문에 존재합니다.

Worktrunk는 그 틈 중 하나에 대한 작고 집중된 답입니다. 11,900이라는 스타 수는 에이전트 셋을 동시에 돌리려다 어려운 부분이 파일 시스템이라는 걸 알게 된 개발자 수입니다.

관련 글