hermes checkpoints Befehl — Vollständige Referenz & Beispiele

Überblick

hermes checkpoints verwaltet den Dateisystem-Checkpoint-Speicher – das Shadow-Git-Repository, das Hermes für die /rollback-Funktion nutzt. Bevor Hermes Schreiboperationen wie write_file, patch oder terminal-Aufrufe ausführt, erstellt es einen Snapshot des Arbeitsverzeichnisses. Dieser Befehl zeigt den Speicher an, bereinigt veraltete Daten oder löscht ihn vollständig.

hermes checkpoints <Unterbefehl>

Unterbefehle

status — Checkpoint-Speicher anzeigen

hermes checkpoints status

Zeigt die Gesamtgröße der Checkpoint-Basis, die Anzahl der verfolgten Projekte und eine Aufschlüsselung pro Projekt.

list — Alias für status

hermes checkpoints list

Identisch zu status; verwende den Namen, der dir besser gefällt.

prune — Veraltete Checkpoints löschen

hermes checkpoints prune

Löscht verwaiste und veraltete Checkpoints und führt eine Garbage Collection durch. Dadurch wird Speicherplatz freigegeben, ohne die gesamte Rollback-Historie zu löschen.

clear — Alle Checkpoints löschen

hermes checkpoints clear

Löscht die gesamte Checkpoint-Basis inklusive der kompletten /rollback-Historie. Nur verwenden, wenn du sicher bist, dass du ältere Operationen nicht mehr zurückrollen musst.

clear-legacy — v1-Migrationsarchive löschen

hermes checkpoints clear-legacy

Entfernt ausschließlich die legacy-<timestamp>/-Archive, die nach der Migration vom v1-Checkpoint-Format übrig geblieben sind.

Häufige Szenarien

Speicherverbrauch prüfen

hermes checkpoints status

Zeigt, wie viel Speicherplatz die Checkpoint-Basis verbraucht und welche Projekte den meisten Platz belegen.

Regelmäßige Bereinigung

hermes checkpoints prune

Periodisch ausführen, um veraltete Checkpoints zu entfernen und Speicherplatz freizugeben.

Nach einem wichtigen Meilenstein neu anfangen

hermes checkpoints clear

Verwenden, wenn du deine Arbeit committed oder gesichert hast und die Rollback-Abdeckung für ältere Änderungen nicht mehr benötigst.

Alte Migrationsarchive entfernen

hermes checkpoints clear-legacy

Kann nach dem Upgrade vom v1-Format sicher ausgeführt werden, falls die Migrations-Backups nicht mehr benötigt werden.

Tipps

• Checkpoints sind die Datenquelle für den /rollback-Befehl im Chat: das Löschen entfernt die Rollback-Fähigkeit für vergangene Operationen.
• prune ist sicherer als clear, da nur veraltete/verwaiste Daten entfernt werden.
• Große Refactoring-Sitzungen können viele Checkpoints erzeugen; überwache die Größe mit status.
• clear-legacy betrifft keine aktuellen Checkpoints – nur alte Migrationsarchive.