hermes-agents.fr

hermes sessions et hermes memory

Sessions SQLite (list, stats, export) et mémoire permanente (MEMORY.md, USER.md, providers externes). Drapeaux et sorties réelles v0.21.2.

01

hermes sessions : le magasin SQLite

usage: hermes sessions [-h]
                       {list,export,delete,prune,archive,optimize,clean-markers,optimize-storage,repair,repair-routing,recover,stats,rename,pin,unpin,pinned,retitle-skills,browse,import}
                       ...

View and manage the SQLite session store

positional arguments:
  {list,export,delete,prune,archive,optimize,clean-markers,optimize-storage,repair,repair-routing,recover,stats,rename,pin,unpin,pinned,retitle-skills,browse,import}
    list                List recent sessions
    export              Export sessions to JSONL, Markdown, or QMD
    delete              Delete a specific session
    prune               Delete old sessions (filterable by time window,
                        source, title, ...)
    archive             Bulk-archive (soft-hide) sessions matching filters -
                        no deletion
    optimize            Reclaim disk space: merge FTS5 segments + VACUUM (no
                        data change)
    clean-markers       Permanently clear stale tool-call marker content left
                        by sessions from before #78148
    optimize-storage    Migrate the search index to the compact v23 layout
                        (reclaims disk on large DBs)
    repair              Repair a malformed state.db schema so hidden sessions
                        reappear
    repair-routing      Re-stamp gateway sessions that lost their routing
                        identity
    recover             Rebuild canonical session data into a separate clean
                        database
    stats               Show session store statistics
    rename              Set or change a session's title
    pin                 Pin session(s) : durable keep flag, exempt from auto-
                        archive
    unpin               Remove the pin (durable keep flag) from session(s)
    pinned              List pinned sessions
    retitle-skills      Re-title sessions whose auto-title came from a
                        /skill's own text
    browse              Interactive session picker : browse, search, and
                        resume sessions
    import              Import a Claude Code or Codex CLI session into Hermes

options:
  -h, --help            show this help message and exit

list affiche les sessions avec dates, stats donne les compteurs, export produit un JSON portable. Reprendre une session récente se fait à l'ouverture de l'agent ; une session ancienne se relance explicitement avec --resume.

02

hermes memory : la mémoire permanente

usage: hermes memory [-h] {setup,status,off,reset} ...

Set up and manage external memory provider plugins. Available providers:
honcho, openviking, mem0, hindsight, holographic, retaindb, byterover. Only
one external provider can be active at a time. Built-in memory
(MEMORY.md/USER.md) is always active.

positional arguments:
  {setup,status,off,reset}
    setup               Interactive provider selection and configuration
    status              Show current memory provider config
    off                 Disable external provider (built-in only)
    reset               Erase all built-in memory (MEMORY.md and USER.md)

options:
  -h, --help            show this help message and exit

Deux fichiers font le travail : MEMORY.md (notes de l'agent) et USER.md (qui vous êtes). Injectés à chaque session. Un seul provider externe à la fois, la mémoire intégrée reste toujours active.

  • setup : sélection interactive (honcho, openviking, mem0, hindsight, holographic, retaindb, byterover)
  • status : provider actif et état
  • reset : effacement destructeur des deux fichiers
03

La discipline qui garde le contexte lisible

Une session qui grossit coûte de plus en plus de jetons par tour : compactez avec /compact dès la lenteur se sent, ou repartez sur du neuf avec /new. La mémoire se cultive : une note utile économise des explications répétées, une note obsolète pollue chaque conversation.