recall
Search past decisions, patterns, and pitfalls using vector search and multi-factor scoring to surface relevant memories before responding.
Instructions
Search for relevant memories using vector search and six-factor scoring.
Primary read path — call before every non-trivial response to surface past decisions, patterns, and pitfalls. Combines vector similarity (LanceDB ANN), weight decay, recency, scope match, access count, and type boost into a single relevance score.
Read-only: yes. No side effects. May trigger background consolidation (non-blocking) if interval has elapsed.
Args: query: Natural language description of what you're looking for. 5-15 words works best. E.g. "how do we handle API auth?" scope: Scope to search. Auto-detected from project config or CWD. Use 'global' to search only cross-project memories. token_budget: Maximum tokens for returned content across all results (default 2000). Results accumulated until budget exhausted. min_score: Minimum final relevance score 0.0–1.0 (default 0.3). Score ≥ 0.6 = directly applicable, 0.4-0.6 = hint/context, < 0.4 = ignore. limit: Maximum candidates to score from ANN search (default 30). type_filter: Restrict to specific memory types, e.g. ['semantic', 'permanent'] to exclude ephemeral session captures.
Returns: list[dict]: Scored, deduplicated memory objects sorted by final_score descending. Embeddings and binary fields stripped. Empty list if no results above min_score.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Natural language query. 5-15 words works best. E.g. 'how do we handle API auth?' | |
| scope | No | Scope to search. Auto-detected if omitted. Use 'global' for cross-project only. | |
| token_budget | No | Maximum total tokens for returned content across all results. | |
| min_score | No | Minimum relevance threshold 0.0–1.0. >=0.6 directly applicable, 0.4-0.6 hint/context, <0.4 ignore. | |
| limit | No | Maximum candidates to score from ANN search. | |
| type_filter | No | Restrict to specific memory types, e.g. ['semantic', 'permanent']. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |