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

Read-only

Yes. This tool only reads from your memory.

Example usage

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.