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

# Inaktive VS-Code-Agent-Worktrees bereinigen, ohne die Sitzung zu verlieren

> Ein dokumentationsbasierter Leitfaden zur manuellen Worktree-Bereinigung in VS Code 1.141 – einschließlich Vorauswahl, Schutzmaßnahmen, Wiederherstellung und separater Preview-Automatik.

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.

Visual Studio Code 1.141 Stable, veröffentlicht am 7. Oktober 2026, ergänzt einen Editor zum Bereinigen von Agent-Sitzungen in isolierten Worktrees. Wenn ältere Sitzungen lokale Worktrees auf dem Datenträger hinterlassen haben, `Chat: Open Worktree Cleanup` zeigt er berechtigte Sitzungen und die geschätzte Größe jedes Worktrees an. Sie wählen aus, was entfernt werden soll. Dieser Leitfaden stützt sich auf [die Microsoft-Versionshinweise](https://code.visualstudio.com/updates/v1_141) und die [Dokumentation zur Sitzungsverwaltung](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions); BIG CHANGE hat keine Bereinigung ausgeführt und keinen eingesparten Speicherplatz gemessen.

## Ausgewählte Worktrees vor dem Bestätigen prüfen

1. Öffnen Sie in VS Code 1.141 die Befehlspalette und führen Sie `Chat: Open Worktree Cleanup`.
2. Wählen Sie einen Inaktivitätsfilter: 7, 15, 30, 60 oder 90 Tage. Er legt fest, welche Sitzungen infrage kommen; er ist kein Countdown bis zur automatischen Löschung.
3. Prüfen Sie jede Sitzung und die geschätzte Größe ihres Worktrees. Berechtigte Worktrees sind **standardmäßig ausgewählt**. Heben Sie die Auswahl für Sitzungen auf, die Sie behalten möchten – auch für Arbeit, deren Branch oder Dateien Sie noch nicht geprüft haben.
4. Bestätigen Sie die Bereinigung nur für die weiterhin ausgewählten Elemente.

VS Code markiert jede ausgewählte Sitzung als abgeschlossen und plant die Entfernung ihres Worktrees. Vor dem Entfernen übernimmt VS Code nicht committete Änderungen in den Branch der Sitzung. Kann VS Code Änderungen nicht sichern oder den Worktree nicht entfernen, bleibt dieser bestehen. Der Sitzungs- und Branchverlauf bleibt verfügbar. Finden Sie die Sitzung über den Filter **Done** im Agents-Fenster (oder über **Archived** in der Chat-Ansicht) und stellen Sie sie wieder her, um den Worktree aus dem Branch neu zu erstellen. Die Dokumentation beschreibt diesen Schutz, garantiert jedoch weder die Entfernung jedes infrage kommenden Worktrees noch eine bestimmte Menge an freigegebenem Speicherplatz.

Der Bereinigungseditor zeigt aktive, laufende, auf Eingaben wartende oder angeheftete Sitzungen nicht an. Ebenfalls ausgeblendet werden abgeschlossene, archivierte, unbenannte oder fehlerhafte Sitzungen, Sitzungen, die jünger als der gewählte Grenzwert sind, sowie Worktrees, deren Größe VS Code nicht ermitteln kann. Eine im Editor fehlende Sitzung beweist daher nicht, dass ihr Worktree verschwunden ist.

## Bereinigung und Löschen einer Sitzung unterscheiden

Bei der manuellen Worktree-Bereinigung bleiben Sitzung und Branch erhalten. **Delete** ist eine andere Aktion: Laut VS-Code-Dokumentation ist das Löschen einer Sitzung endgültig und kann nicht rückgängig gemacht werden. Bei Copilot-Sitzungen werden auch zugehörige Worktrees gelöscht; für gemeinsam genutzte Worktrees gilt abweichendes Verhalten. Die Dokumentation warnt, dass nicht committete Dateien verloren gehen können, wenn sie nur in einem entfernten Worktree vorhanden sind. Verwenden Sie für den dokumentierten wiederherstellbaren Ablauf den Bereinigungseditor und prüfen Sie vor der Auswahl, welche Arbeit Sie noch benötigen.

## Vorschläge und automatische Bereinigung in Preview

Die optionale Einstellung `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` zeigt im Agents-Fenster einen Vorschlag an, wenn inaktive Worktrees mindestens 5 GiB belegen oder 20 Worktrees infrage kommen. Der Vorschlag öffnet denselben Prüfeditor, entfernt aber keinen Worktree. Sie können ihn für das aktuelle Fenster schließen, **Don't Show Again**wählen oder `Chat: Disable Session Storage Cleanup Suggestions`ausführen.

VS Code dokumentiert außerdem die **automatische Bereinigung von Sitzungen** als Preview-Funktion. Beide Einstellungen sind standardmäßig deaktiviert. `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` legt fest, wie lange eine berechtigte Agent-Host-Sitzung inaktiv sein muss, bevor sie als abgeschlossen markiert wird. `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` legt eine separate Karenzzeit fest, bevor VS Code eine automatisch als abgeschlossen markierte Sitzung endgültig löscht. Beide Einstellungen akzeptieren eine positive ganze Zahl von Tagen; `0` deaktiviert diese Stufe. VS Code empfiehlt `15` Tage, doch das ist ein Einstellungsrat und nicht der manuelle Filter für 7, 15, 30, 60 oder 90 Tage.

Für die automatische Preview-Bereinigung muss eine Sitzung inaktiv sein, den konfigurierten Zeitraum seit der letzten Änderung überschritten haben, mit mindestens einem zusammengeführten Pull Request verknüpft sein und darf keinen zugehörigen offenen Pull Request haben. Externe Sitzungen sind ausgeschlossen. Bei aktivierter Einstellung prüft VS Code beim Start und stündlich. Eine Sitzung, die Sie selbst als abgeschlossen markieren, wird auf diesem Weg nicht automatisch gelöscht; durch die Wiederherstellung einer automatisch abgeschlossenen Sitzung entfällt ihre Löschberechtigung. Damit die automatische Bereinigung einen Worktree entfernt, muss dessen Branch einem Upstream-Branch folgen und darf weder ausgehende Commits noch nicht committete Änderungen enthalten. Bei unbekanntem Git-Status oder nicht erfüllten Bedingungen bleibt der Worktree bestehen. Laut VS Code wird er durch diesen Ablauf niemals erzwungen entfernt.

Wenn Sie Größen prüfen und ältere Worktrees selbst auswählen möchten, eignet sich der manuelle Editor. Die Preview-Einstellungen betreffen einen enger gefassten Lebenszyklus in Verbindung mit zusammengeführten Pull Requests und können infrage kommende Sitzungen schließlich endgültig löschen. In diesen Dokumenten werden keine gesonderten Gebühren für die Bereinigungsfunktion genannt. Wie viel Speicherplatz tatsächlich frei wird, hängt von den Worktrees ab, die die Bedingungen erfüllen und entfernt werden.

## Die große Änderung

- Entwicklerinnen und Entwickler mit isolierten Agent-Sitzungen in Worktrees können jetzt in VS Code 1.141 die geschätzte Größe jedes infrage kommenden inaktiven Worktrees sehen und auswählen, welche bereinigt werden sollen.
- Bei der manuellen Bereinigung werden ausgewählte Sitzungen als abgeschlossen markiert, der Branchverlauf bleibt erhalten und nicht committete Änderungen werden vor dem Entfernen des Worktrees übernommen. Schlägt das Sichern oder Entfernen fehl, bleibt der Worktree bestehen; durch Wiederherstellen der Sitzung wird er neu erstellt.
- Infrage kommende Worktrees sind anfangs ausgewählt. Prüfen Sie die Liste vor dem Bestätigen. VS Code schließt aktive, laufende, auf Eingaben wartende oder angeheftete Sitzungen aus; daraus geht jedoch nicht hervor, ob Sie die Arbeit einer inaktiven Sitzung noch benötigen.
- Die automatische Bereinigung in Preview folgt eigenen Regeln für zusammengeführte Pull Requests und kann Sitzungen nach einer konfigurierten Karenzzeit endgültig löschen. Ihre Einstellungen sind anfangs deaktiviert.

## Quellen und weiterführende Informationen

Die Versionshinweise zu VS Code 1.141 nennen den Start des Bereinigungseditors in Stable und beschreiben seinen Zweck. Die Microsoft-Dokumentation *Manage agent sessions in VS Code* erläutert Filter, Vorauswahl, Schutzmaßnahmen, Wiederherstellung und die separaten Regeln der automatischen Preview-Bereinigung. Beide Dokumente sind unten im Quellenmodul aufgeführt.

## Sources

- [Versionshinweise zu Visual Studio Code 1.141](https://code.visualstudio.com/updates/v1_141) — Stable-Veröffentlichungsdatum und Ankündigung der manuellen Worktree-Bereinigung.
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — Manuelle Filter, Auswahl, Schutz, Ausschlüsse, Wiederherstellung, Vorschläge und automatische Bereinigung in Preview.