memanto recall

Retrieve memories using semantic search, with optional temporal modes.

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

Memories are scored using Information Theoretic Similarity (ITS), providing nuanced relevance measurements. Use the min_similarity parameter to filter out results below a certain threshold:

Label	Score Range	Description
Close Match	score ≥ 0.894	Near-perfect relevance to the query
Very High Relevance	0.632 ≤ score < 0.894	Strongly related content
High Relevance	0.447 ≤ score < 0.632	Significantly related content
Good Relevance	0.316 ≤ score < 0.447	Moderately related content
Low Relevance	0.224 ≤ score < 0.316	Minimally related content
Very Low Relevance	0.1 ≤ score < 0.224	Barely related content
Irrelevant	score < 0.1	No meaningful relation to the query

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:

memanto recall "What about the customer?"

Filter by type:

memanto recall "preferences" --type preference

Specific limit:

memanto recall "customer info" --limit 10

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

# 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:

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.

Getting Started

Agent Management

Session Management

Data

Migrate

Search & Discovery

AI Generation

System & Configuration

Schedule

Connect

memanto recall

memanto recall

ITS Scoring

​memanto recall

​ITS Scoring

memanto recall

ITS Scoring