Skip to main content

​
memanto recall

Retrieve memories using semantic search, with optional temporal modes.
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: 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, i.e. how well the memory matches the query (0.0–1.0)
  • --min-confidence FLOAT - Minimum stored confidence score on the memory itself (0.0–1.0). Memories with no stored confidence value are kept rather than dropped — imported memories often carry none, and filtering them out silently would hide them.
  • --tags TEXT - Filter by tags (comma-separated)
  • --as-of DATETIME - Point-in-time query: what was true at this date? (YYYY-MM-DD, ISO 8601, or a relative time string)
  • --changed-since DATE - Differential query: what changed since this date? (YYYY-MM-DD, ISO 8601, or a relative time string)
  • --recent - Chronological query: return the most recently stored memories (newest first). Pairs with --limit and --type; ignores QUERY, --tags, --min-similarity, and --min-confidence.
  • --active - Only active memories (exclude expired)
  • --expired - Only expired memories
  • --tool TEXT - Slug of the AI tool making the call (e.g. claude-code, cursor). For agents, not people — see Tool attribution.
--as-of, --changed-since, and --recent are mutually exclusive. So are --active and --expired.

​
Relative time strings

--as-of and --changed-since accept a plain-English phrase instead of a timestamp: past is a synonym for last everywhere (past 7 days, past week), and N may be spelled out (last seven days, last twelve hours).
Two things to know:
  • last month and last year are fixed 30- and 365-day lookbacks, not calendar windows. Use an explicit YYYY-MM-DD when you need a calendar boundary.
  • --as-of yesterday resolves to the end of yesterday, not the start — a point-in-time query asks what was true at the close of that day. Every other day-based phrase resolves to the start of its day.
Anything not recognized as a relative phrase is parsed as ISO 8601; if that also fails, the command exits with the accepted formats rather than querying.

​
Lifecycle filtering

By default recall returns active and expired memories together, each labelled — expired memories are surfaced to the reader, not hidden from them:
--as-of cannot be combined with --active / --expired: a point-in-time query already returns exactly the memories that were active at that date, including ones that have expired since. See Memory Lifecycle. Examples: Basic recall:
Filter by type:
Specific limit:
Temporal queries (no QUERY — these modes list memories chronologically):
Tag filter:
Output:
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.