Store something in memory.

Args: text: The content to remember. memory_type: One of 'episodic' (conversation fragment), 'semantic' (structured fact), or 'lesson' (correction/rule). key: Required for semantic type. Format: 'pref.theme', 'project.name', 'user.role', etc. importance: 0.0-1.0, how important this memory is. Higher = slower decay. Default 0.5. tags: Comma-separated tags for episodic memories.

Search memory by semantic similarity.

Args: query: What to search for. Can be a question, topic, or keyword. memory_type: One of 'all', 'semantic', 'episodic', or 'lessons'. limit: Max results to return. Default 10. score_threshold: Minimum similarity score (0.0–1.0) to include a result. Applied to semantic cosine scores and episodic decay scores. Default 0.35. Set to 0.0 to disable filtering. category: Filter lessons by category (e.g. 'preference', 'tool', 'knowledge'). Only applied when memory_type includes lessons. Empty string returns all.

Store a correction or rule that should always be followed.

These have the highest priority and override other memories.

Args: rule: The rule or correction. e.g. "Always use wikilinks when writing to Obsidian" category: One of 'preference', 'tool', 'knowledge'. Default 'preference'.

Remove a memory.

Args: memory_type: One of 'semantic', 'episodic', or 'lesson'. identifier: The key (for semantic) or ID number (for episodic/lesson).

Show memory statistics — counts, age, and decay health per memory tier.

Hard-delete decayed and soft-deleted episodic memories.

Removes soft-deleted rows and any active episodic rows whose maximum possible decay score has fallen below score_floor (~115 days at default).

Args: score_floor: Rows with max possible decay score below this are removed. Default 0.05. Set lower (e.g. 0.01) to be more conservative.