Search memories (compact candidates)
search_memory_lightSearches atomic memories by free-text query to find relevant candidates when summaries are insufficient. Returns compact records for follow-up with get_memory_detail.
Instructions
Lexical FTS5 search across atomic memories. Returns compact candidate records only — not full content. USE WHEN: the summary tools above do not provide enough context AND the request includes a concrete search phrase (command name, symbol, past event). DO NOT USE WHEN: summaries already answer the question, the query is empty/too vague, or you only need the global/project/task summary. CALL ORDER: always call summary tools first. Then follow up this tool's top 1-3 results with get_memory_detail — never dump all candidates. RETURNS: { count, results: [{ id, title, summary, memory_type, level, importance, updated_at }] }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max candidate results, 1-20. Defaults to 10. | |
| query | Yes | Free-text search query — a keyword, command, or phrase | |
| scope | No | Search scope: 'project' (scoped to resolved project) or 'global' (all projects). | project |
| git_root | No | Absolute path to the git repository root | |
| project_id | No | Explicit project id | |
| remote_url | No | Git remote URL | |
| workspace_path | No | Absolute path to the workspace root |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| results | Yes |