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

# memanto recall

> Retrieve memories using semantic search, with optional temporal query modes.

# memanto recall

Retrieve memories using semantic search, with optional temporal modes.

```bash theme={null}
memanto recall QUERY [OPTIONS]
```

**Arguments:**

* `QUERY` - Search query (omit when using `--as-of`, `--changed-since`, or `--recent` — those modes list memories chronologically and ignore any query)

## ITS Scoring

<Snippet file="its-scoring.mdx" />

**Options:**

* `-t, --type TEXT` - Filter by memory type (e.g. `fact`, `preference`)
* `-n, --limit INTEGER` - Maximum number of results (default: server-configured `RECALL_LIMIT`, max: 100)
* `--min-similarity FLOAT` - Minimum similarity score (`0.0`–`1.0`)
* `--tags TEXT` - Filter by tags (comma-separated)
* `--as-of DATETIME` - Point-in-time query: what was true at this date? (`YYYY-MM-DD` or ISO 8601)
* `--changed-since DATE` - Differential query: what changed since this date? (`YYYY-MM-DD` or ISO 8601)
* `--recent` - Chronological query: return the most recently stored memories (newest first). Pairs with `--limit` and `--type`; ignores `QUERY`, `--tags`, and `--min-similarity`.

`--as-of`, `--changed-since`, and `--recent` are mutually exclusive.

**Examples:**

Basic recall:

```bash theme={null}
memanto recall "What about the customer?"
```

Filter by type:

```bash theme={null}
memanto recall "preferences" --type preference
```

Specific limit:

```bash theme={null}
memanto recall "customer info" --limit 10
```

Temporal queries (no `QUERY` — these modes list memories chronologically):

```bash theme={null}
# As of a specific moment
memanto recall --as-of "2026-05-01T12:00:00Z"

# Changed since last week
memanto recall --changed-since "2026-05-03"

# Most recently stored memories (newest first)
memanto recall --recent --limit 10

# Narrow temporal queries by type
memanto recall --changed-since "2026-05-03" --type decision
memanto recall --recent --type fact
```

Tag filter:

```bash theme={null}
memanto recall "billing" --tags "vip,enterprise"
```

**Output:**

```
Found 3 memories:

1. Customer prefers email contact
   Type: preference
   Confidence: 0.98
   Created: 2026-05-08 09:00:00 UTC
   Source: user | Provenance: explicit_statement
   Tags: vip, billing

2. Will deliver report by Friday
   Type: commitment
   Confidence: 1.0
   Created: 2026-05-08 14:30:00 UTC
   Source: agent | Provenance: inferred

3. In PST timezone
   Type: fact
   Confidence: 0.95
   Created: 2026-05-07 10:15:00 UTC
   Source: agent | Provenance: explicit_statement
```

Each result also surfaces its provenance metadata when present:

* **Source** — where the memory came from: `user`, `agent`, or the uploaded file name for file-based memories.
* **Ref** — a pointer to the original record within that source (e.g. a tool-call id or migration id). Only shown when set.
* **Provenance** — how the memory was obtained: `explicit_statement`, `inferred`, `corrected`, `validated`, `observed`, or `imported`.
* **Tags** — any tags attached to the memory.