memory_recall
Read-onlyIdempotent
Search past sessions for decisions, solutions, facts, and lessons before starting a new task.
Instructions
Search ALL memory: decisions, solutions, facts, lessons from ALL past sessions. 6-stage pipeline: FTS5+BM25 → semantic → fuzzy → graph → (optional) CrossEncoder → (optional) MMR. Default: hybrid mode (BM25 + semantic + RRF). Use BEFORE starting any task. v11.0: routes to fast hot path when MEMORY_MODE=fast (default). Use memory_search_fast / memory_explain_search for explicit fast routing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Progressive-disclosure mode: 'search' (default) = normal results, 'index' = ultra-compact metadata only (id+title+score+type+project+created_at, ~40-60 tok/hit, no cognitive expansion, use memory_get(ids=...) to fetch full content), 'timeline' = top-K hits expanded with ±neighbors from same session (chronological) | search |
| type | No | all | |
| limit | No | ||
| query | Yes | What to search for | |
| branch | No | Filter by git branch (also includes branch-agnostic records) | |
| detail | No | Level of detail: 'compact' ~50 tokens/result (id+title+score), 'summary' truncates content to 150 chars, 'full' returns everything, 'auto' picks based on query complexity (paths/urls/code → full, short → compact). Ignored when mode!='search'. | full |
| fusion | No | Score fusion method: 'rrf' = Reciprocal Rank Fusion (better multi-tier ranking), 'legacy' = original additive scoring | rrf |
| intent | No | Filter by classified intent (question|procedural|fact|decision|problem|solution|incident|plan) | |
| rerank | No | Enable CrossEncoder re-ranking for higher precision (adds ~30ms latency) | |
| topics | No | Filter results to records tagged with any of these topics (from deep enrichment) | |
| diverse | No | Enable MMR diversity to reduce redundant results (useful for broad queries) | |
| project | No | Filter by project name | |
| entities | No | Filter by extracted entity names (technology/person/project, case-insensitive) | |
| neighbors | No | Timeline mode only: how many records before/after each hit to include. | |
| expand_budget | No | Max number of additional records to include via graph expansion | |
| decisions_only | No | Return only structured decisions (v8.0): type=decision AND tags contain 'structured'. Results include parsed schema payload under 'decision'. | |
| expand_context | No | Add graph-related records (1-hop neighbors via knowledge graph) as 'expansion' results |