Skip to Content
Skip to Content
프로젝트워크트리로 작업 분리

워크트리로 작업 분리

워크트리는 같은 Git 저장소에 별도의 작업 폴더를 만드는 기능입니다. 한 작업에서 오류를 고치는 동안 다른 작업에서 기능을 추가하는 것처럼, 파일 변경을 분리해야 할 때 사용합니다.

일반 새 작업은 대화만 새로 시작하며 같은 프로젝트 폴더에서 작업합니다. 워크트리를 만들면 별도 폴더에서 파일 변경도 분리할 수 있습니다. 새 워크트리는 선택한 브랜치나 커밋을 기준으로 분리된 HEAD 상태에서 시작하므로, 작업 브랜치는 나중에 만들 수 있습니다. Git 저장소가 아닌 폴더에서는 사용할 수 없습니다.

새 채팅에서 워크트리 만들기

  1. Git 프로젝트를 선택합니다.
  2. 새 작업을 열고 입력창 옆의 톱니바퀴 메뉴를 선택합니다.
  3. 워크트리 만들기를 켭니다.
  4. 시작할 브랜치를 선택합니다.
  5. 첫 요청을 입력하고 전송합니다.

메뉴에서 옵션을 고르는 동안에는 Git 파일이 바뀌지 않습니다. 첫 메시지를 보내면 워크트리 생성을 시작하고, 대화 화면에서 준비·파일 체크아웃·설정 진행 상황을 확인할 수 있습니다. 세부 정보 보기에서 출력을 펼치고, 필요하면 취소, 워크트리 사용 안 함 또는 다시 시도를 선택합니다.

워크트리 만들기를 끈 상태에서 브랜치를 선택하면 첫 메시지를 보내기 전에 현재 프로젝트 폴더의 브랜치를 전환합니다. 전환에 실패하면 작성한 내용과 첨부 파일은 입력창에 남습니다.

시작할 작업 선택

프로젝트 메뉴의 새 워크트리에서 기존 대화상자를 열면 다음 시작 방식을 선택할 수 있습니다.

시작 방식포함되는 내용
브랜치·커밋에서 시작선택한 시점의 추적 파일을 사용합니다. 현재 폴더의 커밋하지 않은 변경과 추적되지 않는 파일은 복사하지 않습니다.
현재 작업에서 시작현재 폴더의 커밋하지 않은 변경과 추적되지 않는 파일을 복사합니다. 복사한 변경은 스테이징되지 않으며 Git에서 무시한 파일은 제외됩니다.

생성 경로에 따라 표시되는 선택 항목은 다를 수 있으므로, 시작점과 현재 변경 포함 여부를 확인하세요.

querypie-ai-docs 프로젝트의 ella/aru-manual 루트와 jammy-hedgehog 워크트리가 보이는 작업 위치 메뉴

생성된 환경에서 작업을 시작할 때는 현재 HEAD와 디렉터리를 확인하세요. 패키지 설치나 개발 서버 실행이 필요하다면 새 폴더에서 별도로 준비해야 할 수 있습니다.

작업 위치 확인

파일 링크, 파일 패널과 터미널이 생성된 워크트리 폴더를 가리키는지 확인합니다. 같은 저장소의 작업이라도 다른 워크트리의 변경은 현재 폴더에 바로 반영되지 않습니다.

예를 들어 다음처럼 나눌 수 있습니다.

환경작업
원래 프로젝트 폴더현재 상태 확인과 기존 개발 작업
fix/login-error 워크트리로그인 오류 수정과 검증
feature/report-export 워크트리보고서 내보내기 기능 구현

결과를 기존 브랜치에 반영

워크트리에서 변경 파일과 테스트 결과를 확인한 뒤 Git의 커밋·병합 절차로 기존 브랜치에 반영합니다. 워크트리를 만들거나 작업을 완료하는 것만으로 다른 브랜치에 변경이 합쳐지지는 않습니다.

분리된 HEAD에서 시작했다면 커밋하기 전에 Git 화면에서 브랜치를 만들거나 터미널에서 git switch -c <브랜치-이름>을 실행해 현재 작업을 브랜치에 연결하세요. 이 동작은 자동으로 원격 저장소에 푸시하지 않습니다.

Aru에 반영 작업을 요청할 때는 대상 브랜치와 반영할 변경을 명시하세요. 충돌이 발생하면 결과를 확인하고 해결한 뒤 진행합니다.

fix/login-error 브랜치에서 완료한 변경을 main에 병합하고 싶습니다. 먼저 변경 내용과 테스트 결과를 확인하고, 병합 전에 반영할 커밋과 충돌 여부를 알려 주세요.

변경 → 브랜치 업데이트(Update branch)에서 직접 병합할 수도 있습니다. 반영 대상 브랜치의 작업을 연 뒤 가져올 원본 브랜치를 선택하고, 화면에 표시된 병합 방향을 확인합니다.

Update branch에서 Merge와 Rebase, 병합할 브랜치 및 Merge 버튼을 확인하는 화면

위 이미지는 Update branch 화면의 일반 예시로, origin/main의 변경을 현재 main에 가져오는 설정입니다. 워크트리 결과를 반영할 때는 원본을 해당 작업 브랜치로 바꾸고, 대상이 원하는 기존 브랜치인지 확인하세요.

워크트리 정리

워크트리 제거는 해당 작업 폴더를 정리하는 동작입니다. 브랜치 삭제는 별개의 선택이며, 삭제 화면에서 함께 제거할 대상을 확인해야 합니다.

정리 전에 커밋하지 않은 변경과 필요한 결과 파일을 확인하세요. 현재 브랜치나 루트 워크트리처럼 제거할 수 없는 대상도 있습니다. 제거에 실패하거나 경로가 사라졌다면 먼저 실제 폴더와 Git 상태를 확인합니다.

변경 내용 검토에서 수정한 파일을 비교하는 방법을 확인할 수 있습니다.

Last updated on