Commande hermes checkpoints — Référence Complète & Exemples

Vue d’ensemble

hermes checkpoints gère le magasin de checkpoints du système de fichiers — le dépôt git fantôme qu’Hermes utilise pour la fonction /rollback. Avant qu’Hermes n’effectue des opérations d’écriture comme write_file, patch ou des appels à terminal, il crée un instantané du répertoire de travail. Cette commande permet d’inspecter le magasin, d’élaguer les données obsolètes ou de le vider complètement.

hermes checkpoints <sous-commande>

Sous-commandes

status — Inspecter le magasin de checkpoints

hermes checkpoints status

Affiche la taille totale de la base de checkpoints, le nombre de projets suivis et un récapitulatif par projet.

list — Alias de status

hermes checkpoints list

Identique à status ; utilisez le nom qui vous convient.

prune — Supprimer les checkpoints obsolètes

hermes checkpoints prune

Supprime les checkpoints orphelins et obsolètes et exécute un ramasse-miettes sur le magasin. Cela libère de l’espace disque sans supprimer tout l’historique de /rollback.

clear — Supprimer tous les checkpoints

hermes checkpoints clear

Supprime la base de checkpoints entière, y compris tout l’historique de /rollback. À n’utiliser que lorsque vous êtes sûr de ne plus avoir besoin de revenir en arrière sur des opérations passées.

clear-legacy — Supprimer les archives de migration v1

hermes checkpoints clear-legacy

Supprime uniquement les archives legacy-<horodatage>/ restées après la migration depuis le format v1.

Scénarios courants

Vérifier l’utilisation du disque

hermes checkpoints status

Permet de voir l’espace occupé par la base de checkpoints et quels projets en sont responsables.

Nettoyage périodique

hermes checkpoints prune

À exécuter régulièrement pour récupérer les checkpoints obsolètes et libérer de l’espace disque.

Repartir à zéro après une étape importante

hermes checkpoints clear

À utiliser lorsque votre travail est commité ou sauvegardé et que vous n’avez plus besoin de la protection rollback pour d’anciennes modifications.

Supprimer les anciennes archives de migration

hermes checkpoints clear-legacy

Peut être exécuté en toute sécurité après une mise à niveau depuis le format v1 si les sauvegardes de migration ne sont plus nécessaires.

Astuces

• Les checkpoints alimentent la commande /rollback en session : les supprimer supprime la possibilité de revenir en arrière sur des opérations passées.
• prune est plus sûr que clear car il ne supprime que les données obsolètes/orphelines.
• Les grandes sessions de refactorisation peuvent générer de nombreux checkpoints ; surveillez la taille avec status.
• clear-legacy n’affecte pas les checkpoints actuels, uniquement les anciennes archives de migration.