Git 워크트리
stash 없이 여러 브랜치에서 동시에 작업하세요. 브랜치마다 별도 폴더를 쓰고, 상태 표시줄에서 바로 전환할 수 있습니다.
워크트리는 일상적인 개발에서 가장 짜증 나는 문제 중 하나를 해결해 줍니다. 작업 도중에 브랜치를 바꿔야 하는 상황 말이죠. 워크트리를 쓰면 브랜치를 전환하지 않아도 됩니다. 다른 브랜치를 두 번째 폴더에 열어 두고 두 곳에서 동시에 작업하면 됩니다.
Git 워크트리란?
일반적으로 Git 저장소에는 작업 디렉터리가 하나뿐이며, 파일이 들어 있는 바로 그 폴더입니다. 어느 시점에든 그 폴더에는 정확히 하나의 브랜치만 체크아웃되어 있습니다. 다른 브랜치를 보려면 체크아웃해야 하고, 그러면 파일이 해당 브랜치의 버전으로 바뀝니다. 현재 작업을 커밋하지 않았다면 먼저 stash해야 하는데, 번거롭고 실수하기 쉽습니다.
워크트리는 같은 Git 저장소에 연결된 두 번째(또는 세 번째, 네 번째) 작업 디렉터리입니다. 각 워크트리는 자체 브랜치, 자체 파일 상태, 자체 히스토리를 가집니다. 모두 같은 .git 폴더와 커밋 히스토리를 공유하며, 같은 저장소를 보는 서로 다른 창일 뿐입니다.
구체적인 예를 들어 보겠습니다. AI 에이전트가 feature/payments에서 새 기능을 한창 만들고 있는데, 동료가 fix/login-bug의 PR을 리뷰해 달라고 요청합니다. 기능 작업을 stash하는 대신 fix/login-bug용 워크트리를 별도 폴더에 만듭니다. 그곳에서 PR을 리뷰하는 동안 기능 브랜치는 원래 폴더에서 그대로 유지됩니다.
워크트리 만들기
- Git 패널을 엽니다. Cmd+G를 누르세요.
- 패널 상단의 Worktrees 탭을 클릭합니다.
- + Add Worktree를 클릭합니다.
- 브랜치를 선택합니다. 목록에서 기존 브랜치를 고르거나 새 브랜치 이름을 입력해 만들 수 있습니다.
- 새 워크트리의 폴더 위치를 선택합니다. 기본적으로 1DevTool은 현재 프로젝트 폴더 옆의 폴더를 제안합니다.
- Create를 클릭합니다. 1DevTool이
git worktree add를 실행하고 새 워크트리 폴더를 활성 워크스페이스로 엽니다.
이제 새 워크트리가 Worktrees 탭에 메인 워크트리와 함께 표시됩니다.

워크트리 터미널
1DevTool은 워크트리를 만들 때 해당 워크트리 폴더를 기준으로 하는 새 터미널도 함께 엽니다. 터미널 제목에 브랜치 이름이 표시되므로 지금 어느 브랜치에서 작업 중인지 항상 알 수 있습니다.
그 터미널의 AI 에이전트는 워크트리 폴더에서 동작합니다. 파일을 읽고 쓰고, 명령을 실행하고, 해당 브랜치에서 변경할 수 있으며, 다른 브랜치를 인식하거나 방해하지 않습니다.


여러 워크트리에서 에이전트를 동시에 실행할 수도 있습니다. 한 에이전트는 결제 기능을 만들고, 다른 에이전트는 다른 브랜치에서 버그를 고칩니다. 두 에이전트는 각자 터미널, 파일 컨텍스트, 브랜치를 가지므로 서로 충돌하지 않습니다.
상태 표시줄에서 워크트리 전환하기
프로젝트에 연결된 워크트리가 있으면, 상태 표시줄의 브랜치 칩 옆에 현재 활성 체크아웃의 이름이 색상, 기본(primary)·잠금(locked)·변경됨(dirty) 표시와 함께 나타납니다. Git Client를 열지 않고도 워크트리 사이를 전환할 수 있습니다.

전환 시 다음 두 가지 덕분에 의도한 위치로 정확히 이동합니다.
- 해당 워크트리에 속한 터미널이 앞으로 나옵니다. 다른 체크아웃의 탭에 그대로 남지 않으므로, 명령이 엉뚱한 트리에서 실행되는 가장 흔한 실수를 막아 줍니다.
- 비어 있는 워크트리는 그렇다고 알려 줍니다. 표시된 터미널이 없는 체크아웃에는 다른 곳에서 남은 패널 대신 No terminal in this worktree 메시지와 Add terminal in this worktree 버튼이 표시됩니다.
파일 탐색기도 활성 워크트리를 따라가므로, 탐색 중인 트리가 명령이 실행되는 트리와 일치합니다.
워크트리 제거하기
PR이 머지되고 브랜치도 삭제되는 등 워크트리 사용이 끝나면 깔끔하게 제거할 수 있습니다.
- Git 패널을 열고 Worktrees 탭으로 이동합니다.
- 제거할 워크트리를 찾습니다.
- 옆에 있는 휴지통 아이콘을 클릭합니다.
- 삭제를 확인합니다.
이렇게 하면 워크트리 폴더가 삭제되고 Git에서 등록이 해제됩니다(git worktree remove와 동일). 브랜치 자체는 삭제되지 않고 작업 디렉터리만 제거됩니다. 필요하면 나중에 워크트리를 다시 만들 수 있습니다.
팁: 워크트리를 사용해 기능 브랜치에서 AI 에이전트를 실행하면 main을 안정적으로 유지할 수 있습니다. 에이전트가 실수로 main 브랜치를 망가뜨릴 일이 없습니다.
워크트리는 Git에서 가장 활용도가 낮은 기능 중 하나입니다. 에이전트가 몇 분 만에 수십 개의 파일을 변경할 수도 있는 AI 지원 개발 환경에서는, 각 에이전트의 작업을 자체 브랜치와 폴더로 격리할 수 있다는 점이 매우 든든한 안전장치가 됩니다.