Comando hermes checkpoints — Referência Completa e Exemplos

Visão Geral

hermes checkpoints gerencia o armazenamento de checkpoints do sistema de arquivos — o repositório git sombra que o Hermes usa para o recurso /rollback. Antes de o Hermes executar operações de escrita como write_file, patch ou chamadas terminal, ele cria um snapshot do diretório de trabalho. Este comando permite inspecionar o armazenamento, remover dados obsoletos ou limpá-lo completamente.

hermes checkpoints <subcomando>

Subcomandos

status — Inspecionar o armazenamento de checkpoints

hermes checkpoints status

Mostra o tamanho total da base de checkpoints, quantos projetos são rastreados e o detalhamento por projeto.

list — Alias de status

hermes checkpoints list

Idêntico a status; use o nome de sua preferência.

prune — Remover checkpoints obsoletos

hermes checkpoints prune

Exclui checkpoints órfãos e obsoletos e executa a coleta de lixo na base. Isso libera espaço em disco sem remover todo o histórico de /rollback.

clear — Remover todos os checkpoints

hermes checkpoints clear

Exclui toda a base de checkpoints, incluindo todo o histórico de /rollback. Use apenas quando tiver certeza de que não precisa mais reverter operações anteriores.

clear-legacy — Excluir arquivos de migração da v1

hermes checkpoints clear-legacy

Remove apenas os arquivos legacy-<timestamp>/ restantes da migração do formato v1.

Cenários Comuns

Verificar uso de espaço

hermes checkpoints status

Use para ver quanto espaço a base de checkpoints consome e quais projetos contribuem mais.

Limpeza periódica

hermes checkpoints prune

Execute periodicamente para coletar checkpoints obsoletos e liberar espaço em disco.

Recomeçar após um marco importante

hermes checkpoints clear

Use quando seu trabalho estiver commitado ou backupado e você não precisar mais de cobertura de rollback para alterações antigas.

Remover arquivos de migração antigos

hermes checkpoints clear-legacy

Seguro de executar após atualizar do formato v1, caso não precise mais dos backups de migração.

Dicas

• Os checkpoints são a fonte de dados para o comando /rollback na sessão — removê-los elimina a capacidade de reverter operações passadas.
• prune é mais seguro que clear, pois remove apenas dados obsoletos/órfãos.
• Sessões grandes de refatoração podem gerar muitos checkpoints; monitore o tamanho com status.
• clear-legacy não afeta os checkpoints atuais — apenas arquivos de migração antigos.