Skip to main content
versuno memory recall [query] [--agent <agent>] [--limit <n>] [--format json]
Searches the local memory store at ~/.versuno/memory/ and prints the best matches. Fill the store first with versuno memory capture --local. Everything runs locally. No account, no network. The query is keyword based. The phrase is split into words, common stopwords are dropped, and memories rank by how often the remaining words appear, with title matches counting more than body matches. With no query, recall lists every stored memory, newest first. Recall searches across every project and agent. The store is global by design.

​
Arguments

ArgumentRequiredDescription
queryPositionalSearch terms. Quote multi-word phrases. Omit to list everything.

​
Options

FlagDescription
--agent <agent>Filter by agent: claude, copilot, or codex.
--limit <n>Most results to show. Defaults to 10.
--format jsonPrint structured JSON instead of text. This is what an agent reads.
--hookHook mode for Claude Code. Reads a prompt from stdin and prints matching memory as context. See below.

​
Examples

# Keyword search, matches on: write, prs, github
versuno memory recall "how should I write PRs on github"

# List everything, newest first
versuno memory recall

# Only Claude Code memories, capped at 3
versuno memory recall "auth flow" --agent claude --limit 3

# Structured output for scripts or agents
versuno memory recall "auth flow" --format json

​
JSON output

{
  "query": "auth flow",
  "total": 4,
  "results": [
    {
      "agent": "claude",
      "canonical": "auth-session-handling",
      "summary": "How sessions are resolved...",
      "type_hint": "fact",
      "source_path": "/Users/you/.claude/projects/.../memory/auth.md",
      "section_anchor": null,
      "wikilinks": [],
      "captured_at": "2026-06-27T16:43:40.450Z",
      "content": "...",
      "file": "/Users/you/.versuno/memory/claude/auth-session-handling-1a2b3c4d.md"
    }
  ]
}

​
Hook mode

versuno memory recall --hook is the entrypoint for Claude Code’s UserPromptSubmit hook. It reads the hook JSON from stdin, searches the store against your prompt, and prints a <versuno-memory> block to stdout. Claude Code injects that block alongside your prompt. Hook mode stays quiet unless it’s confident. It only surfaces a memory on a title match, or when at least two distinct query words hit. On empty, irrelevant, or malformed input it prints nothing and never errors, so it can’t block a prompt. Install it with versuno memory install-hook instead of wiring it by hand.

​
See also