Édition Markdown

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

# Nettoyer les worktrees inactifs des agents VS Code sans perdre la session

> Guide fondé sur la documentation pour le nettoyage manuel des worktrees dans VS Code 1.141 : sélections par défaut, protections, restauration et automatisation Preview distincte.

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, publié le 7 octobre 2026, ajoute un éditeur permettant de nettoyer les sessions d’agent isolées dans des worktrees. Si d’anciennes sessions ont laissé des worktrees locaux sur votre disque, `Chat: Open Worktree Cleanup` il affiche les sessions éligibles et la taille estimée de chaque worktree. Vous choisissez ceux à supprimer. Ce guide suit [les notes de version de Microsoft](https://code.visualstudio.com/updates/v1_141) et la [documentation sur la gestion des sessions](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) ; BIG CHANGE n’a pas lancé de nettoyage ni mesuré l’espace économisé.

## Examinez les worktrees sélectionnés avant de confirmer

1. Dans VS Code 1.141, ouvrez la palette de commandes et lancez `Chat: Open Worktree Cleanup`.
2. Choisissez un filtre d’inactivité : 7, 15, 30, 60 ou 90 jours. Il détermine les sessions éligibles ; ce n’est pas un délai avant suppression automatique.
3. Examinez chaque session et la taille estimée de son worktree. Les worktrees éligibles sont **sélectionnés par défaut**. Désélectionnez toute session à conserver, notamment un travail dont vous n’avez pas encore vérifié la branche ou les fichiers.
4. Confirmez le nettoyage uniquement pour les éléments encore sélectionnés.

VS Code marque chaque session sélectionnée comme terminée et programme la suppression de son worktree. Avant de supprimer un worktree, il valide les modifications non validées sur la branche de la session. S’il ne peut pas préserver les changements ou supprimer le worktree, celui-ci reste en place. L’historique de la session et de la branche demeure accessible. Retrouvez la session avec le filtre **Done** de la fenêtre Agents (ou **Archived** dans la vue Chat), puis restaurez-la pour recréer le worktree depuis la branche. La documentation décrit cette préservation, sans garantir que chaque worktree éligible sera supprimé ni qu’une quantité donnée d’espace sera récupérée.

L’éditeur de nettoyage masque les sessions actives, en cours d’exécution, en attente d’une entrée ou épinglées. Il masque aussi les sessions terminées, archivées, sans titre ou en erreur, celles qui sont plus récentes que le seuil choisi et les worktrees dont VS Code ne peut pas mesurer la taille. L’absence d’une session dans l’éditeur ne prouve donc pas que son worktree a disparu.

## Distinguez le nettoyage de la suppression d’une session

Le nettoyage manuel d’un worktree préserve la session et sa branche. **Delete** est une autre action : la documentation de VS Code indique que la suppression d’une session est définitive et irréversible. Pour les sessions Copilot, elle supprime aussi les worktrees associés, sous réserve du comportement des worktrees partagés. La documentation avertit que les fichiers non validés présents uniquement dans un worktree supprimé peuvent être perdus. Utilisez l’éditeur de nettoyage pour le parcours récupérable documenté et vérifiez le travail nécessaire avant de le sélectionner.

## Suggestions et nettoyage automatique Preview

Le paramètre facultatif `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` affiche une suggestion dans la fenêtre Agents lorsque les worktrees inactifs occupent au moins 5 GiB ou que 20 worktrees sont éligibles. Elle ouvre le même éditeur de vérification, mais ne supprime aucun worktree. Vous pouvez la fermer pour la fenêtre en cours, choisir **Don't Show Again** ou lancer `Chat: Disable Session Storage Cleanup Suggestions`.

VS Code documente également le **nettoyage automatique des sessions** comme fonction Preview. Ses deux paramètres sont désactivés par défaut. `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` définit la période d’inactivité avant qu’une session Agent Host éligible soit marquée comme terminée. `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` définit un délai de grâce distinct avant la suppression définitive d’une session que VS Code a automatiquement marquée comme terminée. Les deux acceptent un nombre entier positif de jours ; `0` désactive cette étape. VS Code recommande `15` jours, mais il s’agit d’une suggestion de réglage, pas du filtre manuel de 7/15/30/60/90 jours.

Pour l’automatisation Preview, la session doit être inactive, dépasser le seuil configuré depuis sa dernière modification, être associée à au moins une pull request fusionnée et ne pas avoir de pull request associée encore ouverte. Les sessions externes sont exclues. Lorsque le paramètre est activé, VS Code vérifie au démarrage et toutes les heures. Une session que vous marquez vous-même comme terminée n’est pas supprimée automatiquement par cette voie ; restaurer une session terminée automatiquement supprime son éligibilité à la suppression. Pour que le nettoyage automatique retire un worktree, sa branche doit suivre une branche upstream et ne contenir ni commit sortant ni modification non validée. Un état Git inconnu ou une condition non remplie laisse le worktree en place. VS Code précise que ce processus ne le supprime jamais de force.

L’éditeur manuel est adapté si vous voulez vérifier les tailles et choisir vous-même les anciens worktrees. Les paramètres Preview concernent un cycle de vie plus limité, lié aux pull requests fusionnées, et peuvent finir par supprimer définitivement des sessions éligibles. Ces documents ne mentionnent pas de frais distincts pour la fonction de nettoyage. L’espace réellement récupéré dépend des worktrees qui remplissent les conditions et sont supprimés.

## Le grand changement

- Les développeurs utilisant des sessions d’agent isolées dans des worktrees peuvent désormais voir la taille estimée de chaque worktree inactif éligible dans VS Code 1.141 et choisir lesquels nettoyer.
- Le nettoyage manuel marque les sessions sélectionnées comme terminées, conserve l’historique de la branche et valide les modifications non validées avant de retirer le worktree. En cas d’échec de préservation ou de suppression, le worktree reste en place ; restaurer la session le recrée.
- Les worktrees éligibles sont sélectionnés au départ. Vérifiez la liste avant de confirmer. VS Code exclut les sessions actives, en cours, en attente d’une entrée ou épinglées, mais ces protections ne disent pas si vous avez encore besoin du travail d’une session inactive.
- Le nettoyage automatique Preview suit des règles distinctes pour les pull requests fusionnées et peut supprimer définitivement des sessions après un délai de grâce configuré. Ses paramètres sont désactivés au départ.

## Sources et lectures complémentaires

Les notes de version de VS Code 1.141 indiquent quand l’éditeur de nettoyage est arrivé dans Stable et décrivent son objectif. La documentation Microsoft *Manage agent sessions in VS Code* détaille les filtres, les sélections par défaut, les protections, la restauration et les règles d’automatisation Preview distinctes. Les deux documents figurent dans le module de sources ci-dessous.

## Sources

- [Notes de version de Visual Studio Code 1.141](https://code.visualstudio.com/updates/v1_141) — Date de la version Stable et annonce du nettoyage manuel des worktrees.
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — Filtres manuels, sélection, préservation, exclusions, restauration, suggestions et nettoyage automatique Preview.