get_memory
Retrieve your project's conventions, decisions, and gotchas. Filter by category, type, or keyword. Use before proposing patterns or libraries to ensure alignment with team practices.
Instructions
Routes to the active/current project automatically when known. Retrieves team conventions, architectural decisions, and known gotchas. CALL BEFORE suggesting patterns, libraries, or architecture.
Filters: category (tooling/architecture/testing/dependencies/conventions), type (convention/decision/gotcha), query (keyword search).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Filter by category | |
| type | No | Filter by memory type | |
| query | No | Keyword search across memory and reason | |
| project | No | Optional project selector for this call. Accepts a project root path, file path, file:// URI, or a relative subproject path under a configured root. | |
| project_directory | No | Deprecated compatibility alias for older clients. Prefer project. |
Implementation Reference
- src/memory/store.ts:98-105 (helper)Reads and parses the memories JSON file. Returns empty array on any error.
export async function readMemoriesFile(memoryPath: string): Promise<Memory[]> { try { const content = await fs.readFile(memoryPath, 'utf-8'); return normalizeMemories(JSON.parse(content)); } catch { return []; } }