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

# Limpe worktrees inativos de agentes no VS Code sem perder a sessão

> Um guia baseado na documentação para a limpeza manual de worktrees no VS Code 1.141, incluindo seleções padrão, proteções, restauração e a automação Preview separada.

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.

O Visual Studio Code 1.141 Stable, lançado em 7 de outubro de 2026, adiciona um editor para limpar sessões de agente isoladas em worktrees. Se sessões antigas deixaram worktrees locais no disco, `Chat: Open Worktree Cleanup` ele mostra as sessões qualificadas e o tamanho estimado de cada worktree. Você escolhe o que remover. Este guia segue [as notas de versão da Microsoft](https://code.visualstudio.com/updates/v1_141) e a [documentação de gerenciamento de sessões](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions); a BIG CHANGE não executou uma limpeza nem mediu o espaço economizado.

## Revise os worktrees selecionados antes de confirmar

1. No VS Code 1.141, abra a Paleta de Comandos e execute `Chat: Open Worktree Cleanup`.
2. Escolha um filtro de inatividade: 7, 15, 30, 60 ou 90 dias. Ele define quais sessões se qualificam; não é uma contagem regressiva para exclusão automática.
3. Revise cada sessão e o tamanho estimado do worktree. Os worktrees qualificados vêm **selecionados por padrão**. Desmarque qualquer sessão que queira manter, inclusive trabalhos cujo branch ou arquivos você ainda não verificou.
4. Confirme a limpeza somente dos itens que continuarem selecionados.

O VS Code marca cada sessão selecionada como concluída e agenda a remoção do worktree. Antes de removê-lo, o VS Code registra as alterações não commitadas no branch da sessão. Se não puder preservar as alterações ou remover o worktree, ele permanecerá. O histórico da sessão e do branch continuará disponível. Encontre a sessão usando o filtro **Done** na janela Agents (ou **Archived** na visualização Chat) e restaure-a para recriar o worktree a partir do branch. A documentação descreve essa proteção, mas não garante que todos os worktrees qualificados serão removidos nem que uma quantidade específica de espaço será liberada.

O editor de limpeza não mostra sessões ativas, em execução, aguardando entrada ou fixadas. Também oculta sessões concluídas, arquivadas, sem título ou com erro; sessões mais recentes que o limite escolhido; e worktrees cujo tamanho o VS Code não consegue medir. Portanto, a ausência de uma sessão no editor não prova que o worktree desapareceu.

## Diferencie a limpeza da exclusão de uma sessão

A limpeza manual do worktree preserva a sessão e seu branch. **Delete** é outra ação: a documentação do VS Code diz que excluir uma sessão é definitivo e irreversível. Para sessões do Copilot, isso também remove os worktrees associados, com um comportamento específico para worktrees compartilhados. A documentação alerta que arquivos não commitados presentes apenas em um worktree removido podem ser perdidos. Para o fluxo recuperável documentado, use o editor de limpeza e confira o trabalho necessário antes de selecioná-lo.

## Sugestões e limpeza automática Preview

A configuração opcional `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` mostra uma sugestão na janela Agents quando os worktrees inativos ocupam pelo menos 5 GiB ou há 20 worktrees qualificados. A sugestão abre o mesmo editor de revisão, mas não remove worktrees. Você pode dispensá-la na janela atual, escolher **Don't Show Again**ou executar `Chat: Disable Session Storage Cleanup Suggestions`.

O VS Code também documenta a **limpeza automática de sessões** como um recurso Preview. As duas configurações vêm desativadas por padrão. `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` define por quanto tempo uma sessão qualificada do Agent Host deve ficar inativa antes de ser marcada como concluída. `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` define um período de carência separado antes que o VS Code exclua permanentemente uma sessão marcada como concluída automaticamente. Ambas aceitam um número inteiro positivo de dias; `0` desativa essa etapa. O VS Code recomenda `15` dias, mas isso é uma sugestão de configuração, não o filtro manual de 7, 15, 30, 60 ou 90 dias.

Para se qualificar à automação Preview, a sessão precisa estar inativa, ultrapassar o limite configurado desde a última modificação, estar associada a pelo menos um pull request mesclado e não ter um pull request associado ainda aberto. Sessões externas ficam de fora. Quando a configuração está ativada, o VS Code verifica na inicialização e a cada hora. Uma sessão marcada manualmente como concluída não será excluída automaticamente por esse caminho; restaurar uma sessão concluída automaticamente remove sua elegibilidade para exclusão. Para a limpeza automática remover um worktree, o branch precisa acompanhar um branch upstream e não pode ter commits pendentes de envio nem alterações não commitadas. Se o estado do Git for desconhecido ou uma condição não for atendida, o worktree permanece. O VS Code diz que esse processo nunca força a remoção do worktree.

Se você quiser conferir os tamanhos e escolher manualmente worktrees antigos, use o editor manual. As configurações Preview tratam de um ciclo de vida mais restrito, ligado a pull requests mesclados, e podem acabar excluindo permanentemente sessões qualificadas. Esses documentos não indicam uma cobrança separada pelo recurso de limpeza. O espaço realmente liberado depende dos worktrees que atendem às condições e são removidos.

## A grande mudança

- Desenvolvedores que usam sessões de agente isoladas em worktrees agora podem ver no VS Code 1.141 o tamanho estimado de cada worktree inativo qualificado e escolher quais limpar.
- A limpeza manual marca as sessões selecionadas como concluídas, preserva o histórico do branch e registra alterações não commitadas antes de remover o worktree. Se a preservação ou a remoção falhar, o worktree permanece; restaurar a sessão o recria.
- Os worktrees qualificados já vêm selecionados. Revise a lista antes de confirmar. O VS Code exclui sessões ativas, em execução, aguardando entrada ou fixadas, mas essas proteções não indicam se você ainda precisa do trabalho de uma sessão inativa.
- A limpeza automática Preview segue regras próprias para pull requests mesclados e pode excluir permanentemente sessões após um período de carência configurado. As configurações começam desativadas.

## Fontes e leituras adicionais

As notas de versão do VS Code 1.141 indicam quando o editor de limpeza chegou ao Stable e descrevem seu objetivo. A documentação da Microsoft *Manage agent sessions in VS Code* detalha filtros, seleções padrão, proteções, restauração e as regras separadas da automação Preview. Os dois documentos aparecem no módulo de fontes abaixo.

## Sources

- [Notas de versão do Visual Studio Code 1.141](https://code.visualstudio.com/updates/v1_141) — Data de lançamento do Stable e anúncio da limpeza manual de worktrees.
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — Filtros manuais, seleção, preservação, exclusões, restauração, sugestões e limpeza automática Preview.