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 e a documentação de gerenciamento de sessões; 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 Againou 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.