Comando hermes sessions — Referência Completa e Exemplos

Visão Geral

hermes sessions visualiza e gerencia o armazenamento de sessões SQLite. Você pode listar, navegar, exportar, excluir, podar, arquivar, reparar e otimizar as conversas mantidas pelo Hermes.

hermes sessions <list|browse|export|delete|prune|archive|optimize|clean-markers|optimize-storage|repair|recover|stats|rename|retitle-skills>

Subcomandos

list — Listar sessões recentes

hermes sessions list
hermes sessions list --limit 20
hermes sessions list --source telegram
hermes sessions list --workspace /caminho/para/projeto

browse — Seletor interativo de sessões

hermes sessions browse
hermes sessions browse --limit 100

export — Exportar sessões para arquivo

hermes sessions export --format md ./exports
hermes sessions export --session-id abc123 --format jsonl -
hermes sessions export --older-than 30d --format md --yes

Formatos: jsonl, md, qmd, html, trace. Muitos filtros estão disponíveis (título, fonte, modelo, custo, tokens, chamadas de ferramentas, etc.).

delete — Excluir uma sessão específica

hermes sessions delete abc123
hermes sessions delete abc123 --yes

prune — Excluir sessões antigas por filtros

hermes sessions prune
hermes sessions prune --older-than 90d
hermes sessions prune --source cli --keep 50 --dry-run

O limite de idade padrão é 90 dias se nenhum filtro for fornecido.

archive — Ocultar sessões sem excluí-las

hermes sessions archive --older-than 30d --dry-run
hermes sessions archive --title "legacy" --yes

optimize — Recuperar espaço em disco (sem alterar dados)

hermes sessions optimize

Mescla segmentos FTS5 e executa VACUUM. Nenhum dado de conversação é alterado.

clean-markers — Corrigir marcadores de tool-call residuais

hermes sessions clean-markers --dry-run
hermes sessions clean-markers --yes

optimize-storage — Reconstruir o índice de busca no layout v23 compacto

hermes sessions optimize-storage --yes
hermes sessions optimize-storage --no-vacuum

repair — Reparar um esquema state.db malformado

hermes sessions repair --check-only
hermes sessions repair --no-backup

recover — Recuperação offline de um banco de dados danificado

hermes sessions recover --source state.db --output recovered.db
hermes sessions recover --source state.db --inspect-only

Flags: --source, --output, --inspect-only, --work-dir, --chunk-size, --allow-partial, --report.

stats — Mostrar estatísticas do armazenamento de sessões

hermes sessions stats

rename — Definir ou alterar o título de uma sessão

hermes sessions rename abc123 "Sessão de Design de API"

retitle-skills — Regenerar títulos para sessões de /skill

hermes sessions retitle-skills --dry-run
hermes sessions retitle-skills --apply --limit 200

Cenários Comuns

Encontrar e exportar uma sessão

hermes sessions list --limit 50
hermes sessions export --session-id abc123 --format md ./exports

Limpeza regular

hermes sessions prune --older-than 90d --yes
hermes sessions optimize

Reparar um banco de dados que não mostra sessões

hermes sessions repair --check-only
hermes sessions repair

Recuperar de um backup danificado

hermes sessions recover --source ~/.hermes/backups/state.db --output ~/.hermes/recovered.db --allow-partial

Dicas

• export usa jsonl por padrão; md para arquivos legíveis e trace para o Claude Code Trace Viewer.
• prune sem filtros exclui sessões com mais de 90 dias; use --dry-run para visualizar.
• archive oculta sessões, mas não libera tanto espaço quanto delete ou prune.
• repair e recover fazem backup por padrão; use --no-backup apenas se aceitar o risco.
• retitle-skills é útil quando muitas sessões foram tituladas automaticamente a partir do corpo de um /skill em vez da solicitação real do usuário.