Skip to main content

​
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:
LabelScore RangeDescription
Close Matchscore ≥ 0.894Near-perfect relevance to the query
Very High Relevance0.632 ≤ score < 0.894Strongly related content
High Relevance0.447 ≤ score < 0.632Significantly related content
Good Relevance0.316 ≤ score < 0.447Moderately related content
Low Relevance0.224 ≤ score < 0.316Minimally related content
Very Low Relevance0.1 ≤ score < 0.224Barely related content
Irrelevantscore < 0.1No 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-confidence FLOAT - Minimum confidence 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-confidence.
--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

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

3. In PST timezone
   Type: fact
   Confidence: 0.95
   Created: 2026-05-07 10:15:00 UTC