Edición en Markdown

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

# Limpiar worktrees inactivos de agentes de VS Code sin perder la sesión

> Guía basada en la documentación sobre la limpieza manual de worktrees de VS Code 1.141: selecciones predeterminadas, protecciones, restauración y automatización independiente en vista previa.

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, publicado el 7 de octubre de 2026, incorpora un editor para limpiar sesiones de agentes aisladas en worktrees. Si sesiones antiguas han dejado worktrees locales en el disco, `Chat: Open Worktree Cleanup` muestra las sesiones que cumplen los requisitos y el tamaño estimado de cada worktree. Tú eliges cuáles eliminar. Esta guía sigue [las notas de lanzamiento de Microsoft](https://code.visualstudio.com/updates/v1_141) y la [documentación de gestión de sesiones](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions); BIG CHANGE no ejecutó la limpieza ni midió el espacio ahorrado.

## Revisa los worktrees seleccionados antes de confirmar

1. En VS Code 1.141, abre la paleta de comandos y ejecuta `Chat: Open Worktree Cleanup`.
2. Elige un filtro de inactividad: 7, 15, 30, 60 o 90 días. Determina qué sesiones cumplen los requisitos; no es un temporizador de borrado automático.
3. Lee cada sesión y el tamaño estimado de su worktree. Los worktrees que cumplen los requisitos están **seleccionados de forma predeterminada**. Desmarca cualquier sesión que quieras conservar, incluido el trabajo cuya rama o archivos aún no hayas revisado.
4. Confirma la limpieza solo para las selecciones restantes.

VS Code marca cada sesión seleccionada como finalizada y programa la eliminación de su worktree. Antes de eliminarlo, confirma los cambios sin commit en la rama de esa sesión. Si no puede conservar los cambios o eliminar el worktree, este permanece. El historial de la sesión y la rama siguen disponibles. Localiza la sesión mediante el filtro **Done** de la ventana Agents (o **Archived** en la vista Chat) y restáurala para recrear el worktree desde la rama. La documentación describe esta conservación, pero no promete que se elimine todo worktree elegible ni que se recupere una cantidad concreta de espacio.

El editor de limpieza omite las sesiones activas, en ejecución, a la espera de datos y fijadas. También omite las finalizadas, archivadas, sin título o con errores, las sesiones más recientes que el umbral elegido y los worktrees cuyo tamaño VS Code no puede medir. Por tanto, que una sesión no aparezca en el editor no demuestra que su worktree haya desaparecido.

## Separa la limpieza del borrado de una sesión

La limpieza manual del worktree conserva la sesión y la rama. **Delete** es una acción distinta: la documentación de VS Code dice que borrar una sesión es permanente e irreversible. En las sesiones de Copilot también elimina los worktrees asociados, con las salvedades de los worktrees compartidos. La documentación advierte que pueden perderse los archivos sin commit que solo existan en un worktree eliminado. Usa el editor de limpieza para la vía recuperable documentada e inspecciona antes el trabajo que necesites.

## Sugerencias y limpieza automática en vista previa

El ajuste opcional `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` muestra una sugerencia en la ventana Agents cuando los worktrees inactivos ocupan al menos 5 GiB o hay 20 worktrees elegibles. La sugerencia abre el mismo editor de revisión; no elimina ningún worktree por sí sola. Puedes descartar la sugerencia para la ventana actual, elegir **Don't Show Again** o ejecutar `Chat: Disable Session Storage Cleanup Suggestions`.

VS Code también documenta la **limpieza automática de sesiones** como función en vista previa. Sus dos ajustes están desactivados de forma predeterminada. `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` establece el periodo de inactividad antes de marcar como finalizada una sesión elegible de Agent Host. `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` establece un periodo de gracia independiente antes de borrar permanentemente una sesión que VS Code haya finalizado automáticamente. Ambos aceptan un número entero positivo de días; `0` desactiva esa fase. VS Code recomienda `15` días, pero es una sugerencia de configuración, no el filtro de 7/15/30/60/90 días del editor manual.

Para la automatización en vista previa, la sesión debe estar fuera de progreso, superar el umbral de última modificación, estar asociada al menos a una solicitud de cambios combinada y no tener solicitudes relacionadas abiertas. Se excluyen las sesiones externas. VS Code comprueba al inicio y cada hora mientras el ajuste esté activado. Una sesión que tú marques como finalizada no se elimina automáticamente por esta vía; restaurar una sesión finalizada automáticamente elimina su elegibilidad para el borrado. Para que la limpieza automática quite un worktree, su rama debe seguir una rama upstream y no tener commits pendientes de enviar ni cambios sin commit. Si el estado de Git se desconoce o falla una condición, el worktree permanece. VS Code afirma que este proceso nunca lo elimina por la fuerza.

El editor manual es la opción pertinente si quieres revisar tamaños y elegir worktrees antiguos. Los ajustes de vista previa corresponden a un ciclo de vida más limitado, basado en solicitudes de cambios combinadas, y pueden acabar borrando sesiones elegibles. En estos documentos, VS Code no indica un cargo separado por la función de limpieza. El espacio recuperado depende de los worktrees que cumplan las condiciones y se eliminen.

## El gran cambio

- Los desarrolladores con sesiones de agentes aisladas en worktrees ya pueden ver el tamaño estimado de cada worktree inactivo elegible en VS Code 1.141 y elegir cuáles limpiar.
- La limpieza manual marca las sesiones seleccionadas como finalizadas, conserva el historial de la rama y guarda los cambios sin commit antes de quitar el worktree. Si falla la conservación o la eliminación, el worktree permanece; al restaurar la sesión, se recrea.
- Los worktrees elegibles aparecen seleccionados inicialmente. Revisa la lista antes de confirmar. VS Code excluye sesiones activas, en ejecución, a la espera de datos y fijadas, pero esas protecciones no determinan si aún necesitas el trabajo de una sesión inactiva.
- La limpieza automática en vista previa sigue reglas separadas para solicitudes de cambios combinadas y puede borrar sesiones permanentemente tras un periodo de gracia configurado. Sus ajustes están desactivados al inicio.

## Fuentes y lecturas adicionales

Las notas de lanzamiento de VS Code 1.141 indican cuándo llegó el editor de limpieza a Stable y describen su finalidad. La documentación de Microsoft sobre *Manage agent sessions in VS Code* detalla los filtros, las selecciones predeterminadas, las protecciones, la restauración y las reglas independientes de automatización en vista previa. Ambos documentos aparecen en el módulo de fuentes siguiente.

## Sources

- [Notas de lanzamiento de Visual Studio Code 1.141](https://code.visualstudio.com/updates/v1_141) — Fecha de la versión Stable y anuncio de la limpieza manual de worktrees.
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — Filtros manuales, selección, conservación, exclusiones, restauración, sugerencias y limpieza automática en vista previa.