Comando hermes checkpoints — Referencia Completa y Ejemplos

Descripción General

hermes checkpoints gestiona el almacén de checkpoints del sistema de archivos: el repositorio git en la sombra que Hermes utiliza para la función /rollback. Antes de que Hermes realice operaciones de escritura como write_file, patch o llamadas a terminal, toma una instantánea del directorio de trabajo. Este comando permite inspeccionar el almacén, podar datos obsoletos o borrarlo por completo.

hermes checkpoints <subcomando>

Subcomandos

status — Inspeccionar el almacén de checkpoints

hermes checkpoints status

Muestra el tamaño total del almacén, cuántos proyectos están rastreados y un desglose por proyecto.

list — Alias de status

hermes checkpoints list

Es idéntico a status; usa el nombre que prefieras.

prune — Eliminar checkpoints obsoletos

hermes checkpoints prune

Elimina checkpoints huérfanos y obsoletos y ejecuta la recolección de basura. Esto libera espacio en disco sin borrar todo el historial de /rollback.

clear — Eliminar todos los checkpoints

hermes checkpoints clear

Borra el almacén de checkpoints completo, incluyendo todo el historial de /rollback. Úsalo solo cuando estés seguro de que ya no necesitas revertir operaciones pasadas.

clear-legacy — Borrar archivos de migración de la v1

hermes checkpoints clear-legacy

Elimina únicamente los archivos legacy-<timestamp>/ sobrantes de la migración del formato v1.

Escenarios Comunes

Verificar uso de disco

hermes checkpoints status

Úsalo para ver cuánto espacio ocupa el almacén de checkpoints y qué proyectos contribuyen más.

Limpieza periódica

hermes checkpoints prune

Ejecútalo periódicamente para recolectar checkpoints obsoletos y liberar espacio.

Empezar de cero tras un hito importante

hermes checkpoints clear

Úsalo cuando hayas confirmado o respaldado tu trabajo y ya no necesites cobertura de rollback para cambios antiguos.

Eliminar archivos de migración antiguos

hermes checkpoints clear-legacy

Es seguro ejecutarlo tras actualizar desde el formato v1 si ya no necesitas las copias de migración.

Consejos

• Los checkpoints son la fuente de datos del comando /rollback en sesión: borrarlos elimina la capacidad de revertir operaciones pasadas.
• prune es más seguro que clear porque solo elimina datos obsoletos u huérfanos.
• Las sesiones de refactorización grandes pueden generar muchos checkpoints; monitoriza el tamaño con status.
• clear-legacy no afecta los checkpoints actuales, solo los archivos de migración antiguos.