> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# versuno memory recall

> Search your local memory store without an account.

```
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`](/cli/memory-capture). 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

| Argument | Required   | Description                                                      |
| -------- | ---------- | ---------------------------------------------------------------- |
| `query`  | Positional | Search terms. Quote multi-word phrases. Omit to list everything. |

## Options

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

## Examples

```bash theme={null}
# 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

```json theme={null}
{
  "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`](/cli/memory-install-hook) instead of wiring it by hand.

## See also

* [versuno memory capture](/cli/memory-capture) fills the local store
* [versuno memory install-hook](/cli/memory-install-hook) wires recall into Claude Code