새 워크트리 만들기
저장소의 기본 브랜치에서 새 브랜치를 만들고, 그 브랜치를 체크아웃한 폴더를 한 번에 생성합니다.1
+ 버튼 누르기
사이드바에서 저장소 행에 마우스를 올리면 나타나는 
+ 버튼(워크트리 추가)을 클릭합니다.2
새 브랜치 이름 입력
만들 브랜치 이름을 입력합니다.
다이얼로그 아래에 기준 브랜치가
기준: main 처럼 표시되며, 기준은 origin/HEAD → 로컬 main → 로컬 master 순으로 해석됩니다.3
워크트리 경로 확인
경로는
<저장소부모>/<저장소이름>-<브랜치> 형태로 자동 제안되고, 브랜치 이름의 / 는 - 로 바뀝니다.
직접 편집하기 전까지는 브랜치 이름에 따라 갱신되며, 찾아보기… 로 부모 폴더를 바꿀 수 있습니다.4
생성
생성 을 누르면 새 워크트리가 만들어지고 자동으로 선택됩니다.
워크트리 전환하기
사이드바에서 워크트리 행을 클릭하면 전환됩니다. 실제로 다른 워크트리로 바뀔 때 열려 있던 diff 탭은 모두 닫히고 히스토리(History) 탭 하나로 초기화됩니다.
워크트리 삭제하기
1
삭제 버튼 열기
연결된 워크트리 행에 마우스를 올리면 앞섬/뒤처짐 카운터 자리에 휴지통 아이콘이 나타납니다.
2
옵션 확인
다이얼로그에 두 개의 토글이 있습니다(둘 다 기본 꺼짐).
- 브랜치도 함께 삭제 — 체크아웃돼 있던 브랜치까지 지웁니다. 강제 삭제가 꺼져 있으면 병합되지 않은 브랜치는 삭제가 거부됩니다. 분리된 HEAD 워크트리에는 나타나지 않습니다.
- 강제 삭제 — 커밋하지 않은 변경이 있는 워크트리도 제거합니다.
3
삭제 실행
삭제 를 누릅니다.
삭제한 워크트리가 선택 중이었다면 선택은 기본 워크트리로 이동합니다.
워크트리는 지워졌지만 브랜치 삭제만 실패한 경우에는 경고 토스트로 부분 실패를 알려 줍니다.
잠긴 워크트리 삭제 실패와 재시도
삭제 실패 시 위험은 한 단계씩만 높아집니다.- 강제 삭제 꺼짐 상태로 실패 — 실패 토스트에 액션 버튼이 붙지 않습니다. 원인(커밋되지 않은 변경 또는 잠금)이 안내되며, 다음 단계로 가려면 다이얼로그를 다시 열어 강제 삭제 토글을 직접 켜야 합니다.
- 강제 삭제가 잠금에 막힘 — 이때만 토스트에 잠금 무시하고 삭제 버튼이 나타납니다. Git의 원본 에러 메시지에 잠금 사유가 들어 있어 누가 잠갔는지 확인할 수 있습니다. 잠금이 아닌 이유로 실패했다면 버튼은 나타나지 않습니다.
- 잠금 무시도 실패 — 더는 재시도 버튼이 붙지 않습니다. 에러 메시지를 보고 직접 해결해야 합니다.