Search

Two retrieval modes

• Semantic — searches the meaning of your query across the embeddings of every memory. Great for "what did I decide about the auth flow?".
• Keyword — traditional full-text search. Use it when you know the exact term (function names, IDs, tags).

The two run side by side; results are merged and ranked. You can force a mode by using the filter bar in the OmegaVault app.

Recall from MCP clients

When a connected client (Claude, Cursor, etc.) asks a question, OmegaVault's MCP server runs a semantic search in the background and returns the top matches as context. The client never sees your whole vault — only the relevant slice.

Filters & scopes

• Collection — limit to one project or topic bucket.
• Source — only memories from a specific client.
• Tags — AND/OR combinations on your tag set.
• Date range — created or last edited within a window.

Programmatic search

The same search runs over the API and MCP. See the API reference for the query shape.

POST /v1/memories/search
{
  "query": "auth flow decision",
  "mode": "semantic",
  "limit": 10,
  "filters": { "collection": "project-atlas" }
}