Commande hermes sessions — Référence Complète & Exemples

Vue d’ensemble

hermes sessions affiche et gère le stockage de sessions SQLite. Vous pouvez lister, parcourir, exporter, supprimer, élaguer, archiver, réparer et optimiser les conversations conservées par Hermes.

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

Sous-commandes

list — Lister les sessions récentes

hermes sessions list
hermes sessions list --limit 20
hermes sessions list --source telegram
hermes sessions list --workspace /chemin/vers/projet

browse — Sélecteur de sessions interactif

hermes sessions browse
hermes sessions browse --limit 100

export — Exporter les sessions vers un fichier

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

Formats : jsonl, md, qmd, html, trace. De nombreux filtres sont disponibles (titre, source, modèle, coût, tokens, appels d’outils, etc.).

delete — Supprimer une session spécifique

hermes sessions delete abc123
hermes sessions delete abc123 --yes

prune — Supprimer les anciennes sessions selon des filtres

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

Le seuil d’âge par défaut est de 90 jours si aucun filtre n’est fourni.

archive — Masquer des sessions sans les supprimer

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

optimize — Récupérer de l’espace disque (sans changer les données)

hermes sessions optimize

Fusionne les segments FTS5 et effectue un VACUUM. Aucune donnée de conversation n’est modifiée.

clean-markers — Corriger les marqueurs d’appel d’outil résiduels

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

optimize-storage — Reconstruire l’index de recherche au format v23 compact

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

repair — Réparer un schéma state.db malformé

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

recover — Récupération hors ligne d’une base de données endommagée

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

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

stats — Afficher les statistiques du stockage de sessions

hermes sessions stats

rename — Définir ou modifier le titre d’une session

hermes sessions rename abc123 "Session de conception d'API"

retitle-skills — Régénérer les titres des sessions /skill

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

Scénarios courants

Trouver et exporter une session

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

Nettoyage régulier

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

Réparer une base de données vide

hermes sessions repair --check-only
hermes sessions repair

Récupérer depuis une sauvegarde endommagée

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

Astuces

• export utilise jsonl par défaut ; md pour des archives lisibles et trace pour le Claude Code Trace Viewer.
• prune sans filtres supprime les sessions de plus de 90 jours ; utilisez --dry-run pour prévisualiser.
• archive masque les sessions mais ne libère pas autant d’espace que delete ou prune.
• repair et recover effectuent des sauvegardes par défaut ; n’utilisez --no-backup qu’en acceptant le risque.
• retitle-skills est utile quand de nombreuses sessions ont été automatiquement titrées à partir du corps d’un /skill plutôt que de la requête réelle de l’utilisateur.