Markdown版

AI-translated from English; not yet reviewed by a fluent editor.

# セッションを失わずに非アクティブな VS Code エージェントの worktree を整理する

> VS Code 1.141の手動 worktree 整理を文書に基づいて解説するガイド。初期選択、安全策、復元、別機能である Preview 自動整理を扱う。

By BIG CHANGE Editorial

Published: 2026-10-08T06:14:55.344Z
Updated: 2026-10-08T06:14:55.344Z
Canonical: https://bigchange.ai/blog/vscode-agent-worktree-cleanup-guide

![Conceptual charcoal illustration of a developer at a monitor with a desktop computer tower under the workbench.](https://bigchange.ai/api/media/file/vscode-worktree-storage-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no VS Code interface or measured result is depicted.

2026年10月7日に公開された Visual Studio Code 1.141 Stable には、worktree で分離されたエージェントセッションを整理するエディターが追加された。古いセッションがローカル worktree をディスクに残している場合、 `Chat: Open Worktree Cleanup` 対象となるセッションと各 worktree の推定サイズが表示される。削除するものは自分で選ぶ。このガイドは [Microsoft のリリースノート](https://code.visualstudio.com/updates/v1_141) と [セッション管理ドキュメント](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions)に沿っている。BIG CHANGE は整理を実行しておらず、ストレージの節約量も測定していない。

## 確定する前に選択済み worktree を確認する

1. VS Code 1.141でコマンドパレットを開き、 `Chat: Open Worktree Cleanup`を実行する。
2. 非アクティブ期間のフィルターを7、15、30、60、90日の中から選ぶ。対象セッションを決める条件であり、自動削除までのタイマーではない。
3. 各セッションと worktree の推定サイズを確認する。対象となる worktree は **初期状態で選択されている**。残したいセッションは選択を解除する。ブランチやファイルをまだ確認していない作業も含めて判断する。
4. 残った選択項目だけを整理対象として確定する。

VS Code は選択したセッションを完了としてマークし、その worktree の削除を予定する。削除前に、未コミットの変更をそのセッションのブランチへコミットする。変更を保護できない、または worktree を削除できない場合、worktree は残る。セッションとブランチの履歴は引き続き利用できる。Agents ウィンドウで **Done** フィルターを使う（または Chat ビューで **Archived** を使う）とセッションが見つかる。復元すればブランチから worktree が再作成される。文書はこの保護動作を説明しているが、対象の worktree がすべて削除されることや、特定量のディスク容量が戻ることを保証してはいない。

整理エディターには、アクティブ、実行中、入力待ち、ピン留めのセッションは表示されない。完了済み、アーカイブ済み、無題、エラー状態のセッション、選択した期間より新しいセッション、VS Code がサイズを測れない worktree も除外される。したがって、エディターにセッションがないことは worktree が消えた証拠にはならない。

## セッションの削除と worktree の整理を区別する

手動の worktree 整理ではセッションとブランチが保持される。 **Delete** は別の操作だ。VS Code の文書によると、セッション削除は恒久的で取り消せない。Copilot セッションでは、共有 worktree の扱いを除き、関連する worktree も削除される。削除された worktree にしか存在しない未コミットファイルは失われる可能性があると、文書は警告している。文書化された復元可能な worktree の方法には整理エディターを使い、必要な作業は選択前に確認する。

## 提案と Preview 自動整理

任意の `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` 設定は、非アクティブな worktree が少なくとも5 GiBを使用するか、対象 worktree が20個あるときにAgentsウィンドウへ提案を表示する。提案は同じ確認エディターを開くだけで、worktree は削除しない。現在のウィンドウで提案を閉じるか、 **Don't Show Again**を選ぶか、 `Chat: Disable Session Storage Cleanup Suggestions`を実行できる。

VS Code は **セッションの自動整理** も Preview 機能として説明している。2つの設定は初期状態で無効だ。 `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` は、対象の Agent Host セッションを完了とマークするまでの非アクティブ期間を設定する。 `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` は、VS Code が自動で完了としたセッションを恒久削除するまでの別の猶予期間を設定する。どちらも正の整数の日数を指定し、 `0` でその段階を無効にする。VS Code は `15` 日を推奨しているが、設定の提案であり、手動エディターの7/15/30/60/90日フィルターとは異なる。

Preview 自動化の対象セッションは処理中ではなく、設定した最終変更からの期間を超え、少なくとも1つのマージ済み pull request に関連し、関連する未完了 pull request がない必要がある。外部セッションは対象外だ。設定が有効な間、VS Code は起動時と毎時に確認する。自分で完了としたセッションはこの方法では自動削除されない。自動完了されたセッションを復元すると、削除対象から外れる。自動整理で worktree を削除するには、ブランチが upstream を追跡し、未送信コミットも未コミット変更もないことが必要だ。Git の状態が不明、または条件を満たさない場合は worktree が残る。VS Code はこの処理で強制削除をしないとしている。

サイズを確認して古い worktree を自分で選ぶ場合は手動エディターを使う。Preview 設定はマージ済みPRに限定されたライフサイクルを扱い、条件を満たすセッションを後で恒久削除する可能性がある。VS Code の文書に整理機能の別料金は記載されていない。実際に戻る容量は、条件を満たして削除された worktree によって変わる。

## 大きな変化

- worktree で分離したエージェントセッションを使う開発者は、VS Code 1.141で対象となる非アクティブ worktree の推定サイズを確認し、整理するものを選べるようになった。
- 手動整理では選択したセッションを完了とし、ブランチ履歴を保ち、worktree 削除前に未コミット変更をコミットする。保護や削除に失敗すれば worktree は残り、セッションを復元すると再作成される。
- 対象 worktree は最初から選択されている。確定前に一覧を確認する。VS Code はアクティブ、実行中、入力待ち、ピン留めのセッションを除外するが、それだけでは非アクティブなセッションの作業がまだ必要かは分からない。
- Preview 自動整理はマージ済み pull request に関する別のルールに従い、設定した猶予期間後にセッションを恒久削除する可能性がある。設定は初期状態で無効だ。

## 出典と参考資料

VS Code 1.141のリリースノートは、整理エディターが Stable に入った時期と目的を示す。Microsoft の *Manage agent sessions in VS Code* には、詳細なフィルター、初期選択、安全策、復元手順、別個の Preview 自動化ルールが記載されている。両文書は下の出典モジュールに掲載されている。

## Sources

- [Visual Studio Code 1.141 リリースノート](https://code.visualstudio.com/updates/v1_141) — Stable のリリース日と手動 worktree 整理の発表。
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — 手動フィルター、選択、保護、除外、復元、提案、Preview 自動整理。