hermes sessions Befehl — Vollständige Referenz & Beispiele

Überblick

hermes sessions betrachtet und verwaltet den SQLite-Sitzungsspeicher. Du kannst Gespräche auflisten, durchsuchen, exportieren, löschen, bereinigen, archivieren, reparieren und optimieren.

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

Unterbefehle

list — Aktuelle Sitzungen auflisten

hermes sessions list
hermes sessions list --limit 20
hermes sessions list --source telegram
hermes sessions list --workspace /pfad/zum/projekt

browse — Interaktiver Sitzungs-Selektor

hermes sessions browse
hermes sessions browse --limit 100

export — Sitzungen exportieren

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

Formate: jsonl, md, qmd, html, trace. Viele Filter verfügbar (Titel, Quelle, Modell, Kosten, Tokens, Tool-Aufrufe usw.).

delete — Eine bestimmte Sitzung löschen

hermes sessions delete abc123
hermes sessions delete abc123 --yes

prune — Alte Sitzungen anhand von Filtern löschen

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

Standardmäßig werden ohne Filter Sitzungen älter als 90 Tage gelöscht.

archive — Sitzungen ausblenden, ohne sie zu löschen

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

optimize — Speicherplatz zurückgewinnen (keine Datenänderung)

hermes sessions optimize

Führt FTS5-Segment-Merge und VACUUM durch. Keine Gesprächsdaten werden geändert.

clean-markers — Veraltete Tool-Call-Marker bereinigen

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

optimize-storage — Suchindex in kompaktes v23-Layout überführen

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

repair — Malformiertes state.db-Schema reparieren

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

recover — Offline-Wiederherstellung einer beschädigten Datenbank

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

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

stats — Statistiken zum Sitzungsspeicher anzeigen

hermes sessions stats

rename — Titel einer Sitzung setzen oder ändern

hermes sessions rename abc123 "API-Design-Sitzung"

retitle-skills — Titel für /skill-Sitzungen neu generieren

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

Häufige Szenarien

Sitzung finden und exportieren

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

Regelmäßige Bereinigung

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

Datenbank reparieren, die keine Sitzungen anzeigt

hermes sessions repair --check-only
hermes sessions repair

Wiederherstellung aus beschädigtem Backup

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

Tipps

• export defaultet zu jsonl; md für lesbare Archive und trace für den Claude Code Trace Viewer.
• prune ohne Filter löscht Sitzungen älter als 90 Tage; mit --dry-run vorab prüfen.
• archive blendet Sitzungen aus, gibt aber weniger Speicher frei als delete oder prune.
• repair und recover erstellen standardmäßig Backups; --no-backup nur mit Bedacht.
• retitle-skills ist nützlich, wenn viele Sitzungen automatisch nach dem Inhalt eines /skill statt nach der eigentlichen Benutzeranfrage benannt wurden.