O Visual Studio Code 1.141 Stable, lançado a 7 de outubro de 2026, acrescenta um editor para limpar sessões de agente isoladas em worktrees. Se sessões antigas deixaram worktrees locais no disco, Chat: Open Worktree Cleanup apresenta as sessões elegíveis e uma estimativa do tamanho de cada worktree. É o utilizador que escolhe quais remover. Este guia segue as notas de lançamento da Microsoft e a documentação de gestão de sessões; a BIG CHANGE não executou a limpeza nem mediu o espaço poupado.

Reveja 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. Este determina quais as sessões elegíveis; não é um temporizador de eliminação automática.
  3. Leia cada sessão e o tamanho estimado do respetivo worktree. Os worktrees elegíveis estão selecionados por predefinição. Desmarque qualquer sessão que pretenda manter, incluindo trabalho cuja ramificação ou ficheiros ainda não tenha analisado.
  4. Confirme a limpeza apenas para as seleções restantes.

O VS Code marca cada sessão selecionada como concluída e agenda a remoção do respetivo worktree. Antes de o remover, confirma as alterações não confirmadas na ramificação dessa sessão. Se não conseguir preservar as alterações ou remover o worktree, este permanece. O histórico da sessão e da ramificação continua disponível. Localize a sessão através do filtro Done na janela Agents (ou Archived na vista Chat) e restaure-a para recriar o worktree a partir da ramificação. A documentação descreve este comportamento de preservação, mas não garante que todos os worktrees elegíveis sejam removidos nem uma quantidade específica de espaço recuperado.

O editor de limpeza omite sessões ativas, em execução, à espera de dados e afixadas. Também omite sessões concluídas, arquivadas, sem título ou em estado de erro, sessões mais recentes do que o limite escolhido e worktrees cujo tamanho o VS Code não consegue medir. A ausência de uma sessão neste editor não prova, por isso, que o respetivo worktree tenha desaparecido.

Distinga a limpeza da eliminação de uma sessão

A limpeza manual do worktree preserva a sessão e a ramificação. Delete é uma ação diferente: a documentação do VS Code afirma que a eliminação de uma sessão é permanente e não pode ser anulada. Nas sessões Copilot, também remove os worktrees associados, sujeito ao comportamento de worktrees partilhados. A documentação avisa que os ficheiros não confirmados que existam apenas num worktree removido podem perder-se. Use o editor de limpeza para o percurso de worktree recuperável documentado e inspecione o trabalho necessário antes de o selecionar.

Sugestões e limpeza automática em pré-visualização

A definição opcional chat.agentSessions.sessionStorageCleanupSuggestion.enabled apresenta uma sugestão na janela Agents quando os worktrees inativos ocupam pelo menos 5 GiB ou há 20 worktrees elegíveis. A sugestão abre o mesmo editor de revisão; não remove um worktree por si só. 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 funcionalidade em pré-visualização. As duas definições estão desativadas por predefinição. chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays define o período de inatividade antes de marcar uma sessão elegível do Agent Host como concluída. chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays define um período de tolerância separado antes de eliminar permanentemente uma sessão marcada automaticamente como concluída pelo VS Code. Ambas aceitam um número inteiro positivo de dias; 0 desativa essa fase. O VS Code recomenda 15 dias, mas trata-se de uma sugestão de definição, não do filtro de 7/15/30/60/90 dias do editor manual.

Para a automatização em pré-visualização, a sessão tem de estar fora de progresso, ultrapassar o limite configurado desde a última modificação, estar associada a pelo menos um pedido de alteração integrado e não ter pedidos relacionados abertos. As sessões externas são excluídas. Com a definição ativada, o VS Code verifica no arranque e de hora a hora. Uma sessão marcada como concluída pelo utilizador não é eliminada automaticamente por este percurso; restaurar uma sessão concluída automaticamente retira-lhe a elegibilidade para eliminação. Para a limpeza automática remover um worktree, a respetiva ramificação tem de acompanhar uma ramificação upstream e não ter commits por enviar nem alterações não confirmadas. Um estado Git desconhecido ou o incumprimento de uma condição mantém o worktree. O VS Code afirma que este processo nunca o remove à força.

O editor manual é a opção adequada quando pretende inspecionar tamanhos e escolher worktrees antigos. As definições de pré-visualização dizem respeito a um ciclo de vida mais restrito, associado a pedidos de alteração integrados, e podem acabar por eliminar sessões elegíveis. Estes documentos não indicam um custo separado para a funcionalidade de limpeza do VS Code. O espaço efetivamente recuperado depende dos worktrees que cumprem os critérios e são removidos.

A grande mudança

  • Os programadores com sessões de agente isoladas em worktrees podem agora ver o tamanho estimado de cada worktree inativo elegível no VS Code 1.141 e escolher quais limpar.
  • A limpeza manual marca as sessões selecionadas como concluídas, preserva o histórico da ramificação e confirma as alterações não confirmadas antes de remover o worktree. Se a preservação ou remoção falhar, o worktree permanece; restaurar a sessão volta a criá-lo.
  • Os worktrees elegíveis começam selecionados. Reveja a lista antes de confirmar. O VS Code exclui sessões ativas, em execução, à espera de dados e afixadas, mas essas salvaguardas não indicam se ainda precisa do trabalho de uma sessão inativa.
  • A limpeza automática em pré-visualização segue regras separadas para pedidos de alteração integrados e pode eliminar sessões permanentemente após um período de tolerância configurado. As definições começam desativadas.

Fontes e leituras adicionais

As notas de lançamento do VS Code 1.141 estabelecem quando o editor de limpeza chegou à versão Stable e descrevem a sua finalidade. A documentação da Microsoft Manage agent sessions in VS Code fornece os filtros detalhados, as seleções predefinidas, as salvaguardas, os passos de restauro e as regras de automatização de pré-visualização separadas. Ambos os documentos estão listados no módulo de fontes abaixo.