Comando hermes sessions — Referencia Completa y Ejemplos

Descripción General

hermes sessions visualiza y gestiona el almacén de sesiones SQLite. Puedes listar, explorar, exportar, eliminar, podar, archivar, reparar y optimizar las conversaciones que guarda Hermes.

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

Subcomandos

list — Listar sesiones recientes

hermes sessions list
hermes sessions list --limit 20
hermes sessions list --source telegram
hermes sessions list --workspace /ruta/al/proyecto

browse — Selector interactivo de sesiones

hermes sessions browse
hermes sessions browse --limit 100

export — Exportar sesiones a archivo

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. Hay muchos filtros disponibles (título, fuente, modelo, coste, tokens, llamadas a herramientas, etc.).

delete — Eliminar una sesión específica

hermes sessions delete abc123
hermes sessions delete abc123 --yes

prune — Eliminar sesiones antiguas por filtros

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

El umbral de edad por defecto es 90 días si no se dan filtros.

archive — Ocultar sesiones sin eliminarlas

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

optimize — Recuperar espacio en disco (sin cambiar datos)

hermes sessions optimize

Fusiona segmentos FTS5 y ejecuta VACUUM. No cambia ningún dato de conversación.

clean-markers — Corregir marcadores de tool-call residuales

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

optimize-storage — Reconstruir el índice al diseño v23 compacto

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

repair — Reparar un esquema state.db malformado

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

recover — Recuperación offline de una base de datos dañada

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

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

stats — Mostrar estadísticas del almacén

hermes sessions stats

rename — Establecer o cambiar el título de una sesión

hermes sessions rename abc123 "Sesión de diseño de API"

retitle-skills — Regenerar títulos para sesiones de /skill

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

Escenarios Comunes

Buscar y exportar una sesión

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

Limpieza regular

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

Reparar una base de datos que no muestra sesiones

hermes sessions repair --check-only
hermes sessions repair

Recuperar desde una copia dañada

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

Consejos

• export usa jsonl por defecto; md para archivos legibles y trace para el visor de trazas de Claude Code.
• prune sin filtros elimina sesiones mayores de 90 días; usa --dry-run para previsualizar.
• archive oculta sesiones pero no libera tanto espacio como delete o prune.
• repair y recover hacen copias de seguridad por defecto; usa --no-backup solo si aceptas el riesgo.
• retitle-skills es útil cuando muchas sesiones se titularon automáticamente a partir del cuerpo de un /skill en lugar de la solicitud real del usuario.