Skip to main content
Search is how you and your agents find notes without dumping the vault into context.
  • Command palette: ⌘K / Ctrl+K (also ⌘⇧F). Placeholder: “Search notes or type a command…”.
  • Search in the footer rail opens the Search page. The note list stays mounted.
Type a query. Hits show a title, an excerpt, and provenance (slug and heading trail). Click a row to open the note.

What comes back

Search returns handles, not full bodies. Each hit points at a note. Fetch the body only when you open it. Every response includes coverage:
  • how many notes were searched
  • what was excluded (named folders, not a silent drop)
  • why the set is partial, when it is
On the cloud-shaped vault, private/ is listed in exclusions. Run the local app or local MCP to search those notes. Zero results is valid. Ela would rather return nothing, with coverage saying why, than pad the list. The same query against the same index and ranker versions returns the same hits.

Agents

HTTP search is GET /v1/search. MCP is search_notes. Both carry coverage and provenance. See Agents and API overview.