Search your memories for information relevant to a query.

Returns chunks ranked by relevance using hybrid search (vector + full-text + RRF). Uses query enrichment (keyword extraction + variation) for better recall. Results are budgeted to fit within max_tokens to avoid flooding context.

Args: query: The search query — a question, topic, or keyword phrase. spaces: Filter to specific memory spaces (e.g. ["default", "projects"]). If omitted, searches all spaces. since: Only return memories after this date (ISO format, e.g. "2025-01-01"). limit: Maximum number of results (default 10, max 50). max_tokens: Token budget for results (default 2000). ef_search: How much of the vector index to search, 1-1000. Omit to use the default (40). Raise it when a search should have found something and did not — better recall, slower query. Worth trying before concluding a memory is missing.

Store a new memory in the system.

The text is embedded and stored as a searchable chunk. Use this to save important information, decisions, or knowledge.

Args: text: The text content to remember. space: Which memory space to store it in (default "default"). source: Where this memory comes from (default "mcp"). speaker: Who said/wrote this — "human" or "assistant" (default "human").

Soft-delete a memory chunk by ID.

The chunk is removed from search results but stays in the database for potential recovery. Sets importance to 0 and marks it in metadata.

Args: chunk_id: The UUID of the chunk to forget.

Permanently delete memories that were forgotten a while ago.

forget is a soft delete: the memory stops appearing in search but the row stays, so it can be recovered. Nothing removed it afterwards, so a vault that is edited often accumulated one dead row per edit forever.

This is the deliberate, irreversible half. It is never automatic — there is no timer that quietly deletes your memories — and it only touches memories already marked forgotten, never active ones.

Args: older_than_days: Only purge memories forgotten at least this many days ago. The default keeps a month of recovery, so purging right after an accidental forget still spares it. Pass 0 to purge every forgotten memory regardless of age.

Move a stored memory into a different space.

The memory keeps its content and embedding; only the space it belongs to changes. Its knowledge-graph entries are rebuilt in the target space so the graph and search agree about where it lives.

The target space must already exist — use the dashboard or the API to create one first.

Args: chunk_id: The UUID of the chunk to move. target_space: Name of the space to move it into.

Get the current status of the memory system.

Returns database health, chunk counts per space, and embedding model info.