worktree 만들기와 지우기

만들기

Git 모드의 워크트리 탭에서 엽니다.

• 레포별 보기: 저장소 이름 옆의 +(워크트리 추가)를 누릅니다.
• 상태별 보기: 목록 아래의 워크트리 추가를 누릅니다. 저장소가 여럿이면 어느 저장소에 만들지 먼저 고릅니다.

새 워크트리 창에서 다음을 채웁니다.

• 작업 유형: 새 기능, 버그 수정, 리팩터링, 동작 변경 중 하나입니다. 그 저장소에서 작업 계획을 쓸 때만 보입니다(작업 계획 참고). 고른 유형의 템플릿으로 requirements.md를 미리 채웁니다.
• 브랜치 이름: 새로 만들 브랜치입니다. 저장소의 지금 HEAD에서 갈라집니다.
• 폴더 위치: worktree를 둘 폴더입니다.

폴더 위치 기본값

• 설정의 에이전트 탭에서 worktree 훅을 켰다면 ~/.belloga/worktrees/{owner}/{repo}/{branch}가 채워집니다. Belloga 터미널의 Claude Code도 worktree를 만들기 전에 이 위치를 안내받습니다.
• 켜지 않았다면 저장소 옆에 브랜치 이름의 /를 -로 바꾼 폴더가 채워집니다.

어느 쪽이든 창에서 직접 고칠 수 있습니다.

지우기

worktree 카드의 더 보기 메뉴에서 워크트리 삭제를 고릅니다. 저장소의 기본 worktree는 지울 수 없습니다.

지우기 전에 창이 잃을 것을 세어 보여 줍니다.

• 원격에 올리지 않은 커밋, 원격 사본이 없는 브랜치
• 변경된 파일
• 저장소에 남은 stash
• 함께 닫히는 탭과 저장하지 않은 문서

잃을 것이 없으면 “잃을 변경이 없습니다.“라고 보입니다. 지우면 그 폴더에서 돌던 터미널을 먼저 끝내고 폴더를 지웁니다. 브랜치는 남습니다.

VS Code로 열기

카드의 더 보기 메뉴에서 VS Code에서 열기를 고르면 worktree 폴더를 VS Code로 엽니다.