Skip to main content

memory_search

Layered search across distilled knowledge dossiers with automatic fallback to raw evidence. Returns entity matches with snippets rather than synthesized answers. Use memory_search when you want to browse, explore, or discover entities in your memory — rather than get a direct answer to a specific question.

Parameters

ParameterTypeRequiredDefaultDescription
querystringYesSearch query
depthstringNo"auto"Search depth: "distilled" (entities only), "raw" (conversation history), or "auto" (tries distilled first, falls back to raw)

Read-only

Yes. This tool only reads from your memory.

Example usage

{
  "query": "authentication architecture"
}
{
  "query": "React projects",
  "depth": "distilled"
}
{
  "query": "that conversation about caching",
  "depth": "raw"
}
The response returns entity matches with URIs like baselayer://project/my-app. Use get_entity to read the full dossier for any result.
Prefer ask_question for factual questions where you want a direct answer. Use memory_search when you want to browse or discover what entities exist in your memory.

Depth modes

  • "distilled" — Searches only the knowledge graph (entities and facts). Fast and focused.
  • "raw" — Searches the raw conversation history. Slower, but finds things that haven’t been distilled yet.
  • "auto" — Tries distilled first. If results are insufficient, automatically falls back to raw. This is the default and usually the right choice.
Do not act on partial memory_search results. Always read the full entity with get_entity before making decisions based on search results.