Search memories
search_memoriesUse this before responding to each new user message, to retrieve context relevant to the message and ongoing conversation, even when the user does not explicitly ask you to remember. Form a concise semantic query using the people, projects, preferences, goals, decisions, or events implied by the message; for follow-ups, include enough recent conversational context to make the query meaningful. Search all tiers (omit tiers and importance) unless there is a reason to narrow. If a MemoryRouter recall block was already supplied for this message, that search already ran; search again only for more detail. Read only: searches the user's OAuth-selected vault. Tier guide: tier 3 holds the highest-level consolidated reflections (identity, principles, what matters most), tier 2 holds reflections of specific meaningful events, tier 1 holds raw verbatim memories. Match filters to the question. Broad 'most important things we have done' questions: tiers [3], importance 8 or higher, large limit such as 250. Big-picture overviews like 'what do you know about this area or period': tiers [3] with no importance filter. Specific lookups like 'find the decision about X': omit tiers to search all tiers blended and leave importance unset; a high importance filter hides the specific detail you are looking for. Specific meaningful events without raw noise: tiers [2] or [2, 3]. Exact verbatim detail: if the detail is not already in context, drill down by lineage: search tiers [3] to find the relevant thread, then use inspect_memory on the result to see the tier 2 reflections it consolidated, then inspect those to reach the raw memories underneath. Direct tiers [1] search works when you know exact wording to match. Mixing tiers is legitimate; adjust the importance threshold to the question rather than always setting it high. Only reflections (tiers 2 and 3) carry importance ratings. For time-window questions like 'what happened last week' or 'lately' use date_search_memories instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_memories"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of relevant memories to return. Use a large limit such as 250 for broad 'most important things' questions over tiers [3]. | |
| query | Yes | A concise semantic query built from the people, projects, preferences, goals, decisions, or events implied by the user message, plus enough recent conversational context for follow-ups. | |
| tiers | No | Restrict results to these memory tiers. 3 highest-level consolidated reflections (identity, principles, what matters most), 2 reflections of specific meaningful events, 1 raw verbatim memories. Use [3] for broad 'most important' or big-picture questions, [2] or [2, 3] for specific meaningful events, [1] for exact verbatim detail when you know the wording to match; otherwise drill down from [3] with inspect_memory. Omit to search all tiers blended, the right default for specific lookups. Mixing tiers is fine. Only tiers 2 and 3 carry importance ratings. | |
| importance | No | Minimum importance threshold, 1 to 10. Only reflections (tiers 2 and 3) carry ratings, so raw memories are excluded whenever this is set. Use 8 or higher with tiers [3] for broad 'most important' questions. Leave unset for general or specific searches; a high threshold hides relevant material. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| query | Yes | ||
| memories | Yes | ||
| consolidation_available | No |