Tutoriel 8 : Gestion des sessions

Vous avez déjà fermé votre terminal et perdu une super conversation avec Hermes ? Ou vous vouliez reprendre là où vous en étiez sur ce bug coriace d’hier ? Bonne nouvelle : Hermes se souvient de tout. Chaque conversation est automatiquement sauvegardée sous forme de session, et dans ce tutoriel, nous allons vous montrer comment utiliser ce super-pouvoir.

Comment fonctionnent les sessions

Pensez à une session comme à un journal de discussion avec une étiquette. Que vous parliez à Hermes depuis le CLI, Telegram, Discord, Slack, WhatsApp, ou l’une des 20+ autres plateformes prises en charge, votre conversation est stockée avec tout son historique.

Tout cela vit dans une base de données SQLite à ~/.hermes/state.db. Pour chaque session, Hermes suit :

Un titre unique et lisible
La plateforme utilisée (CLI, Telegram, etc.)
Le modèle et la configuration
L’historique complet des messages avec les appels d’outils et leurs résultats
Les compteurs de tokens et les horodatages
L’ID de la session parente (pour quand les longues discussions sont scindées)

Ce qui entre réellement dans le contexte

Voici une idée reçue courante : Hermes ne relit pas chaque fichier ou image que vous avez déjà partagés. Les médias sont traités tour par tour. Si vous envoyez une image et demandez un mème, Hermes peut l’analyser une fois avec la vision, puis les tours suivants ne transportent qu’une description textuelle ou un chemin local — pas le JPEG brut.

Les vrais consommateurs de contexte, ce sont les textes verbeux : transcriptions collées, journaux géants, gros diffs. La documentation donne un excellent conseil : privilégiez les résumés, les chemins de fichiers et les extraits ciblés plutôt que de copier de gros artefacts dans la discussion.

Reprendre des conversations depuis le CLI

C’est là que la magie opère. Voyons les trois façons de reprendre là où vous vous étiez arrêté.

1. Continuer la dernière session :

hermes --continue
# ou en plus court
hermes -c

Cela récupère votre session CLI la plus récente et charge tout l’historique.

2. Continuer par terminal (c’est nouveau et génial) :

Un simple -c est désormais conscient du terminal. Hermes dépose un petit fichier de repère pour chaque session de terminal. Ainsi, si vous avez deux panneaux de terminal côte à côte, chacun reprend sa propre conversation au lieu de se battre pour la même. Fini les interférences entre panneaux !

S’il n’y a pas de repère (première utilisation, ou s’il date de plus de 30 jours), il revient à la session la plus récente. Vous pouvez désactiver cela avec session.terminal_continue: false dans config.yaml.

3. Reprendre par nom :

Donnez des titres explicites à vos sessions et vous pourrez y revenir directement :

hermes -c "mon projet"

S’il existe des variantes comme “mon projet”, “mon projet #2”, etc., Hermes récupère automatiquement la plus récente.

Reprendre une session spécifique

Besoin de revenir à une conversation particulière ? Utilisez l’ID de session :

hermes --resume 20250305_091523_a1b2c3d4
# ou par titre
hermes --resume "refactorisation auth"
# ou simplement la plus récente
hermes --resume latest

Conseils de pro issus de la documentation

/compress — à utiliser quand une session devient trop longue. Cela réduit le contexte actif (mais attention : ce n’est pas une suppression pour des raisons de confidentialité).
/new payments-refactor — démarrez un nouveau fil avec un titre immédiatement, ce qui facilite sa recherche plus tard avec /resume.
hermes sessions prune — uniquement lorsque vous voulez supprimer les anciennes sessions terminées.
hermes sessions optimize — si state.db est simplement volumineux, cela fusionne les index de recherche et nettoie sans toucher à vos données. Commencez par ça !

Pour conclure

La gestion des sessions, c’est votre super-pouvoir de mémoire. Que vous jongliez entre plusieurs projets dans différents terminaux ou que vous repreniez une session de débogage vieille d’une semaine, Hermes s’occupe de tout. L’essentiel à retenir : utilisez /compress pour les longues discussions, nommez vos sessions avec /new <nom>, et laissez le -c conscient du terminal garder vos panneaux bien organisés.

Bonne discussion !