IntelliJ IDEA 2026.1에서 Git 워크트리 (Git Worktree)가 IDE 네이티브로 지원됩니다.

이번에는 실제로 사용해 본 내용을 정리했습니다.

이 기능을 사용하면 워크트리를 생성하여, 다른 워크트리를 AI 에이전트에게 넘겨주면서 메인 브랜치에서의 작업을 계속하는 등, 중단 없이 동시에 작업을 수행할 수 있습니다.

워크트리 (Worktree)는 동일한 리포지토리(Repository)에서 작업 폴더를 하나 더 늘리는 구조입니다.

.git (이력·브랜치의 본체)은 공유한 채로, 폴더마다 별도의 브랜치를 전개할 수 있습니다.

IntellijWork/
├─ Master/ ← main (메인 작업)
└─ spring-demo-agent/ ← 별도 브랜치 (병행 작업)

다시 클론(Clone)하는 것과 달리, 이력을 이중으로 가지지 않으므로 디스크 용량 측면에서도 유리하다는 장점이 있습니다.

• Git 툴 윈도우 (Alt+9)의 **워크트리 (Worktree)**를 선택

• **「새 워크트리 (New Worktree)」**를 클릭 - 다음을 지정:

  • 원본 브랜치 (Base branch): 기반이 될 브랜치
  • 새 브랜치 (New branch): 새로운 브랜치 이름
  • 프로젝트 이름 (Project name)/위치 (Location): worktree를 생성할 위치

• 「워크트리 생성」을 누르면, 어느 창에서 열지 확인하는 팝업이 나타납니다.

• 현재 열려 있는 창 (Current window): 현재 창이 worktree로 교체됨

• 새 창에서 열기 (New window): 별도의 창에서 worktree가 열림 (현재 프로젝트는 그대로 유지됨)

병행 작업이 목적이라면 새 창에서 열기를 선택하여 두 개의 창(메인과 worktree)을 동시에 띄울 수 있습니다.

생성 후의 관리도 동일한 Git 툴 윈도우의 워크트리 탭에서 할 수 있습니다.

• 전환 (Switching): Worktrees 탭에서 대상 worktree를 더블 클릭하면 해당 창으로 이동할 수 있습니다. IDE 외부(CLI 등)에서 만든 worktree도 여기에 목록으로 표시됩니다.
• 삭제 (Deleting): 불필요해지면 Worktrees 탭에서 삭제.

worktree 측에서 시간이 걸리는 작업을 실행하고, 자신은 메인 측에서 다른 작업을 계속하는 분담 방식을 시도했습니다.

이번에는 worktree 측 (agent/payment-tests 브랜치)에서 AI 코딩 에이전트인 Junie에게 spring-demo-project의 테스트 추가를 요청했고, 실행되는 동안 저는 메인 창 (main)으로 돌아와 다른 작업을 계속했습니다.

worktree 측에서 어떤 일이 일어나고 있더라도, 메인 측은 전혀 영향을 받지 않습니다.

실제로 일련의 작업 동안 main은 마지막까지 깨끗한 상태를 유지했습니다.

$ git -C Master status -sb
## main...origin/main # 변경 사항 없음

에이전트의 작업은 agent/payment-tests 브랜치의 별도 폴더 내에 격리되어 있습니다.

만약 하나의 폴더에서 이 작업을 수행했다면, 실행 중인 쪽의 미완성된 변경 사항과 제 작업이 뒤섞여 혼란스러웠을 것입니다.

「한쪽을 격리하여 실행시키고, 다른 한쪽에서 계속 손을 움직이는 것」이 worktree의 장점이었습니다.

유용한 한편, worktree만의 주의점도 몇 가지 있었습니다.

메인 프로젝트 폴더 내부에 worktree를 만들면, IntelliJ가 이를 멀티 루트 프로젝트 (multi-root project)로 오인하여 연동이 깨집니다.

Projects/main/linkedWorktree와 같은 중첩 배치는 피하고, 별도의 상위 폴더에 만드는 것이 안전합니다.

main을 메인 폴더에서 열고 있는 경우, 다른 worktree에서 동일한 main을 체크아웃(Checkout)할 수는 없습니다.

worktree 측에서는 다른 브랜치(새 브랜치를 만드는 것이 자연스러움)를 사용해야 합니다.

이것이 가장 실용적인 발견이었습니다. 새로 연 worktree 창에는 Maven 툴 윈도우가 나타나지 않았습니다. 메인 측에는 있는데 말이죠.

이유는 이 프로젝트에서 .idea (IntelliJ 프로젝트 설정)를 .gitignore 하고 있기 때문이었습니다. git worktree가 각 폴더에 전개하는 것은 "

git이 추적하고 있는 파일」뿐이므로, ignore된 .idea는 공유되지 않고 worktree마다 새로 생성됩니다. "어떤 pom.xml을 Maven 프로젝트로 취급할 것인가"라는 정보는 .idea 안에 들어있으며, 메인 측에서는 이미 가져오기가 완료되었더라도 새로 연 worktree에는 해당 정보가 없습니다. pom.xml을 우클릭 → "Add as Maven Project"로 다시 가져오니 Maven 툴 윈도우(Tool Window)가 나타났습니다.

IntelliJ IDEA 2026.1의 Git worktree를 실제로 사용해 보았습니다.

• 생성·전환·삭제가 Worktrees 탭(Alt+9) 내에서 완결됨.
• New Window로 열면, 메인과 worktree를 2개 화면으로 동시에 진행할 수 있음. 브랜치 전환을 위한 stash(스태시)도, 빌드 재생성도 필요 없음.
• 한쪽에서 시간이 걸리는 작업(이번에는 에이전트)을 실행시키고, 본인은 메인에서 작업을 계속해도 메인은 변하지 않음.
• 주의할 점은, 중첩하지 말 것 / 동일한 브랜치는 불가 / gitignore된 .idea는 공유되지 않음.

"급한 업무가 들어오면 별도 폴더에서 대응한다", "무거운 처리는 별도 브랜치에 격리하여 실행시켜 둔다"와 같은 병행 작업이 브랜치 전환만으로 가능해집니다.

우선 Worktrees 탭에서 worktree를 하나 만들어, 평소 하던 작업을 2개 화면으로 진행해 보시는 것을 추천합니다.

저희 회사는 JetBrains 제품에 관한 질문이나 상담 등을 접수하고 있습니다. 저희의 X(구 Twitter) 또는 이메일로 연락해 주세요.