mnemon

name: mnemon description: Persistent memory CLI for Hermes Agent. Store facts, recall past knowledge, link related memories, manage lifecycle.

Use mnemon when durable memory can materially improve continuity across Hermes sessions. Hooks may inject recalled context before an LLM call, but the agent decides what is worth storing.

Workflow

Recall when prior decisions, preferences, or facts may affect the current task: mnemon recall "<query>" --limit 10
Remember only stable, reusable knowledge: mnemon remember "<fact>" --cat <cat> --imp <1-5> --entities "e1,e2" --source agent
Link related memories after reviewing candidates from remember: mnemon link <id> <candidate> --type <causal|semantic> --weight <0-1>

Commands

mnemon remember "<fact>" --cat <cat> --imp <1-5> --entities "e1,e2" --source agent
mnemon link <id1> <id2> --type <type> --weight <0-1> [--meta '<json>']
mnemon recall "<query>" --limit 10
mnemon search "<query>" --limit 10
mnemon import --dry-run <file>
mnemon import <file>
mnemon forget <id>
mnemon related <id> --edge causal
mnemon gc --threshold 0.4
mnemon gc --keep <id>
mnemon status
mnemon log
mnemon store list
mnemon store create <name>
mnemon store set <name>
mnemon store remove <name>

Guardrails

Do not store secrets, passwords, tokens, private keys, or short-lived operational noise.
Prefer concise insights over transcript dumps.
Categories: preference · decision · insight · fact · context
Edge types: temporal · semantic · causal · entity
Max 8,000 chars per insight.