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

# Bersihkan worktree agen VS Code yang tidak aktif tanpa kehilangan sesi

> Panduan berbasis dokumentasi untuk pembersihan worktree manual di VS Code 1.141, termasuk pilihan awal, perlindungan, pemulihan, dan otomatisasi Preview yang terpisah.

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, yang dirilis pada 7 Oktober 2026, menambahkan editor untuk membersihkan sesi agen yang diisolasi dalam worktree. Jika sesi lama meninggalkan worktree lokal di disk, `Chat: Open Worktree Cleanup` editor itu menampilkan sesi yang memenuhi syarat dan perkiraan ukuran setiap worktree. Anda yang memilih mana yang akan dihapus. Panduan ini mengikuti [catatan rilis Microsoft](https://code.visualstudio.com/updates/v1_141) dan [dokumentasi pengelolaan sesi](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions); BIG CHANGE tidak menjalankan pembersihan atau mengukur penghematan penyimpanan.

## Tinjau worktree yang dipilih sebelum mengonfirmasi

1. Di VS Code 1.141, buka Command Palette dan jalankan `Chat: Open Worktree Cleanup`.
2. Pilih filter tidak aktif: 7, 15, 30, 60, atau 90 hari. Filter ini menentukan sesi yang memenuhi syarat; ini bukan pengatur waktu penghapusan otomatis.
3. Periksa setiap sesi dan perkiraan ukuran worktree-nya. Worktree yang memenuhi syarat **dipilih secara default**. Hapus centang pada sesi yang ingin dipertahankan, termasuk pekerjaan yang cabang atau filenya belum Anda periksa.
4. Konfirmasikan pembersihan hanya untuk pilihan yang tersisa.

VS Code menandai setiap sesi yang dipilih sebagai selesai dan menjadwalkan penghapusan worktree-nya. Sebelum menghapus worktree, VS Code melakukan commit atas perubahan yang belum di-commit ke cabang sesi tersebut. Jika perubahan tidak dapat dipertahankan atau worktree tidak dapat dihapus, worktree tetap ada. Riwayat sesi dan cabang tetap tersedia. Temukan sesi melalui filter **Done** di jendela Agents (atau **Archived** di tampilan Chat), lalu pulihkan sesi untuk membuat ulang worktree dari cabangnya. Dokumentasi menjelaskan perilaku perlindungan ini, tetapi tidak menjamin setiap worktree yang memenuhi syarat akan dihapus atau sejumlah ruang tertentu akan dipulihkan.

Editor pembersihan tidak menampilkan sesi yang aktif, sedang berjalan, menunggu masukan, atau disematkan. Editor itu juga mengecualikan sesi yang selesai, diarsipkan, tanpa judul, atau berstatus error; sesi yang lebih baru daripada ambang pilihan; dan worktree yang ukurannya tidak dapat diukur VS Code. Jadi, sesi yang tidak muncul di editor bukan bukti bahwa worktree-nya sudah hilang.

## Pisahkan pembersihan worktree dari penghapusan sesi

Pembersihan worktree manual mempertahankan sesi dan cabangnya. **Delete** adalah tindakan berbeda: dokumentasi VS Code menyebut penghapusan sesi sebagai tindakan permanen yang tidak dapat dibatalkan. Untuk sesi Copilot, tindakan itu juga menghapus worktree terkait, dengan perilaku khusus untuk worktree bersama. Dokumentasi memperingatkan bahwa file yang belum di-commit dan hanya ada di worktree yang dihapus dapat hilang. Gunakan editor pembersihan untuk jalur worktree yang dapat dipulihkan sebagaimana didokumentasikan, dan tinjau pekerjaan yang diperlukan sebelum memilihnya.

## Saran dan pembersihan otomatis Preview

Pengaturan opsional `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` menampilkan saran di jendela Agents saat worktree tidak aktif menggunakan setidaknya 5 GiB atau ada 20 worktree yang memenuhi syarat. Saran itu membuka editor peninjauan yang sama; saran tidak menghapus worktree. Anda dapat menutup saran untuk jendela saat ini, memilih **Don't Show Again** , atau menjalankan `Chat: Disable Session Storage Cleanup Suggestions`.

VS Code juga mendokumentasikan **pembersihan sesi otomatis** sebagai fitur Preview. Kedua pengaturannya nonaktif secara default. `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` menetapkan periode tidak aktif sebelum sesi Agent Host yang memenuhi syarat ditandai selesai. `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` menetapkan masa tenggang terpisah sebelum sesi yang otomatis ditandai selesai oleh VS Code dihapus permanen. Keduanya menerima bilangan bulat positif dalam hari; `0` menonaktifkan tahap tersebut. VS Code menyarankan `15` hari, tetapi ini sekadar saran pengaturan, bukan filter 7/15/30/60/90 hari di editor manual.

Untuk otomatisasi Preview, sesi harus tidak sedang diproses, melewati ambang waktu sejak terakhir diubah, terkait dengan setidaknya satu pull request yang telah digabung, dan tidak memiliki pull request terkait yang masih terbuka. Sesi eksternal dikecualikan. Saat pengaturan aktif, VS Code memeriksa saat mulai dan setiap jam. Sesi yang Anda tandai selesai sendiri tidak otomatis dihapus melalui jalur ini; memulihkan sesi yang selesai otomatis menghapus kelayakannya untuk dihapus. Agar pembersihan otomatis menghapus worktree, cabangnya harus melacak upstream dan tidak memiliki commit keluar atau perubahan yang belum di-commit. Status Git yang tidak diketahui atau syarat yang gagal membuat worktree tetap ada. VS Code menyatakan proses ini tidak pernah memaksa penghapusan worktree.

Editor manual adalah pilihan yang tepat bila Anda ingin memeriksa ukuran dan memilih sendiri worktree lama. Pengaturan Preview membahas siklus hidup merged-PR yang lebih sempit dan pada akhirnya dapat menghapus sesi yang memenuhi syarat secara permanen. Dokumen VS Code ini tidak mencantumkan biaya terpisah untuk fitur pembersihan. Ruang yang benar-benar dipulihkan bergantung pada worktree yang memenuhi syarat dan dihapus.

## Perubahan besar

- Pengembang dengan sesi agen yang diisolasi dalam worktree kini dapat melihat perkiraan ukuran setiap worktree tidak aktif yang memenuhi syarat di VS Code 1.141 dan memilih mana yang akan dibersihkan.
- Pembersihan manual menandai sesi yang dipilih sebagai selesai, mempertahankan riwayat cabangnya, dan melakukan commit pada perubahan yang belum di-commit sebelum worktree dihapus. Jika perlindungan atau penghapusan gagal, worktree tetap ada; memulihkan sesi akan membuatnya kembali.
- Worktree yang memenuhi syarat sudah dipilih sejak awal. Tinjau daftarnya sebelum mengonfirmasi. VS Code mengecualikan sesi aktif, berjalan, menunggu masukan, dan disematkan, tetapi perlindungan itu tidak menunjukkan apakah pekerjaan dalam sesi tidak aktif masih Anda perlukan.
- Pembersihan otomatis Preview mengikuti aturan terpisah untuk pull request yang digabung dan dapat menghapus sesi secara permanen setelah masa tenggang yang ditetapkan. Pengaturannya nonaktif saat awal.

## Sumber dan bacaan lanjutan

Catatan rilis VS Code 1.141 menetapkan kapan editor pembersihan masuk ke Stable dan menjelaskan tujuannya. Dokumentasi Microsoft *Manage agent sessions in VS Code* menyediakan filter terperinci, pilihan default, perlindungan, langkah pemulihan, dan aturan otomatisasi Preview yang terpisah. Kedua dokumen tercantum di modul sumber berikut.

## Sources

- [Catatan rilis Visual Studio Code 1.141](https://code.visualstudio.com/updates/v1_141) — Tanggal rilis Stable dan pengumuman pembersihan worktree manual.
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — Filter manual, pemilihan, perlindungan, pengecualian, pemulihan, saran, dan pembersihan otomatis Preview.
