2026년 10월 7일 출시된 Visual Studio Code 1.141 Stable에는 작업 트리로 격리한 에이전트 세션을 정리하는 편집기가 추가됐다. 오래된 세션이 디스크에 로컬 작업 트리를 남겼다면 Chat: Open Worktree Cleanup 이 편집기에서 조건에 맞는 세션과 각 작업 트리의 예상 크기를 확인할 수 있다. 제거할 항목은 사용자가 선택한다. 이 안내는 Microsoft의 릴리스 노트 와 세션 관리 문서를 따른다. BIG CHANGE는 정리를 실행하거나 저장 공간 절약량을 측정하지 않았다.

확인 전에 선택된 작업 트리 검토

  1. VS Code 1.141에서 Command Palette를 열고 Chat: Open Worktree Cleanup를 실행한다.
  2. 비활성 기간 필터를 7, 15, 30, 60, 90일 중에서 선택한다. 이 값은 어떤 세션이 조건을 충족하는지 정하며 자동 삭제 타이머가 아니다.
  3. 각 세션과 작업 트리의 예상 크기를 확인한다. 조건에 맞는 작업 트리는 기본으로 선택되어 있다. 브랜치나 파일을 아직 살펴보지 않은 작업을 비롯해 보관할 세션은 선택을 해제한다.
  4. 나머지 선택 항목에 대해서만 정리를 확인한다.

VS Code는 선택한 세션을 각각 완료 상태로 표시하고 작업 트리 제거를 예약한다. 작업 트리를 제거하기 전에 커밋되지 않은 변경 사항을 해당 세션의 브랜치에 커밋한다. 변경 내용을 보존하거나 작업 트리를 제거할 수 없으면 작업 트리는 남는다. 세션과 브랜치 기록은 계속 사용할 수 있다. Agents 창의 Done 필터(또는 Chat 보기의 Archived 필터)에서 세션을 찾아 복원하면 브랜치에서 작업 트리가 다시 만들어진다. 문서는 이 보존 동작을 설명하지만, 조건에 맞는 모든 작업 트리의 제거 또는 특정 용량의 공간 회수를 보장하지는 않는다.

정리 편집기는 활성, 실행 중, 입력 대기 중, 고정된 세션을 제외한다. 완료, 보관, 제목 없음, 오류 상태의 세션, 선택한 기준보다 최근 세션, VS Code가 크기를 측정할 수 없는 작업 트리도 제외한다. 따라서 편집기에 세션이 나타나지 않는다고 그 작업 트리가 사라졌다는 뜻은 아니다.

세션 삭제와 작업 트리 정리를 구분하기

수동 작업 트리 정리는 세션과 브랜치를 보존한다. Delete 는 별개의 작업이다. VS Code 문서에 따르면 세션 삭제는 영구적이며 되돌릴 수 없다. Copilot 세션은 공유 작업 트리 관련 동작에 따라 연결된 작업 트리도 삭제한다. 제거된 작업 트리에만 있던 미커밋 파일은 손실될 수 있다고 문서는 경고한다. 문서에 나온 복구 가능한 작업 트리 경로를 쓰려면 정리 편집기를 사용하고 필요한 작업을 선택 전에 확인한다.

Preview 제안 및 자동 정리

선택형 chat.agentSessions.sessionStorageCleanupSuggestion.enabled 설정은 비활성 작업 트리가 5 GiB 이상을 차지하거나 조건에 맞는 작업 트리가 20개일 때 Agents 창에 제안을 표시한다. 제안은 같은 검토 편집기를 열 뿐 작업 트리를 직접 제거하지 않는다. 현재 창에서 제안을 닫거나 Don't Show Again을 선택하거나 Chat: Disable Session Storage Cleanup Suggestions를 실행할 수 있다.

VS Code는 자동 세션 정리 도 Preview 기능으로 문서화한다. 관련 설정 두 개는 기본적으로 꺼져 있다. chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays 은 조건에 맞는 Agent Host 세션을 완료로 표시하기 전까지의 비활성 기간을 설정한다. chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays 은 VS Code가 자동으로 완료 처리한 세션을 영구 삭제하기 전의 별도 유예 기간을 설정한다. 두 설정 모두 양의 정수 일수를 받는다. 0 은 해당 단계를 끈다. VS Code는 15 일을 권장하지만, 이는 설정 제안일 뿐 수동 편집기의 7/15/30/60/90일 필터가 아니다.

Preview 자동 정리 대상 세션은 진행 중이 아니어야 하고, 설정한 마지막 수정 기준을 넘겨야 하며, 병합된 pull request가 하나 이상 연결되어 있고 관련해 열린 pull request가 없어야 한다. 외부 세션은 제외된다. 설정이 켜져 있으면 VS Code는 시작 시와 매시간 확인한다. 사용자가 직접 완료로 표시한 세션은 이 경로로 자동 삭제되지 않는다. 자동 완료된 세션을 복원하면 삭제 자격이 해제된다. 자동 정리가 작업 트리를 제거하려면 브랜치가 upstream을 추적하고 내보내지 않은 커밋이나 미커밋 변경이 없어야 한다. Git 상태를 알 수 없거나 조건을 충족하지 못하면 작업 트리는 남는다. VS Code는 이 과정에서 작업 트리를 강제로 제거하지 않는다고 밝힌다.

크기를 확인하고 오래된 작업 트리를 직접 선택하려면 수동 편집기가 적절하다. Preview 설정은 병합된 PR에 연계된 더 좁은 수명 주기를 다루며, 조건에 맞는 세션을 나중에 영구 삭제할 수 있다. 이 문서에는 정리 기능의 별도 요금이 명시되어 있지 않다. 실제 회수 공간은 조건을 충족해 제거되는 작업 트리에 따라 달라진다.

큰 변화

  • 작업 트리로 격리한 에이전트 세션을 사용하는 개발자는 이제 VS Code 1.141에서 조건에 맞는 비활성 작업 트리의 예상 크기를 보고 정리할 항목을 선택할 수 있다.
  • 수동 정리는 선택한 세션을 완료로 표시하고 브랜치 기록을 보존하며, 작업 트리를 제거하기 전에 미커밋 변경을 커밋한다. 보존이나 제거에 실패하면 작업 트리는 남고, 세션을 복원하면 다시 만들어진다.
  • 조건에 맞는 작업 트리는 처음에 선택되어 있다. 확인 전에 목록을 검토한다. VS Code는 활성, 실행 중, 입력 대기, 고정 세션을 제외하지만 이 보호 장치만으로 비활성 세션의 작업이 여전히 필요한지는 알 수 없다.
  • Preview 자동 정리는 병합된 pull request에 별도의 규칙을 적용하고 설정된 유예 기간 뒤 세션을 영구 삭제할 수 있다. 관련 설정은 처음에 꺼져 있다.

출처 및 추가 자료

VS Code 1.141 릴리스 노트는 정리 편집기가 Stable에 들어온 시기와 목적을 설명한다. Microsoft의 Manage agent sessions in VS Code 문서에는 세부 필터, 기본 선택, 보호 장치, 복원 절차, 별도의 Preview 자동화 규칙이 나온다. 두 문서 모두 아래 출처 모듈에 있다.