Create or overwrite a note in the vault.

Args: path: Note path relative to vault root (e.g. "skill/timeout-diagnosis") frontmatter: YAML metadata dict. Required fields: type, confidence. body: Markdown body content. Should start with "# Title".

Returns warnings if the note has structural issues.

Write multiple notes atomically in a single transaction.

Args: entries: List of dicts, each with "path", "frontmatter", "body" keys.

All notes are written together — if one fails, none are committed.

Read a note from the vault. Returns its frontmatter and body.

Args: path: Note path (e.g. "concept/connection-pooling")

Apply an incremental edit to an existing note without rewriting the full content.

Args: path: Note path to edit. operation: One of "replace_string", "set_frontmatter", "replace_section", "append_section". params: Operation-specific parameters: - replace_string: {"old": "...", "new": "..."} - set_frontmatter: {"field": "value", ...} (merge update) - replace_section: {"heading": "## Section", "body": "new content"} - append_section: {"heading": "## Section", "content": "appended text"}

Returns warnings if the edit introduces structural issues.

Delete a note and remove it from all indexes.

Args: path: Note path to delete.

Rename or move a note. All [[backlinks]] in other notes are rewritten automatically.

Args: old_path: Current note path. new_path: New note path.

Browse notes under a path.

Args: path: Directory path (e.g. "skill"). Use "" for vault root. depth: How many levels deep to list (default 1). type_filter: Only return notes of this type (e.g. "skill", "concept").

Search the vault by keyword, semantic similarity, or both.

Args: query: Search query text. filters: Optional filters: {"type": "skill", "confidence": "fact", "tags": ["db"]}. mode: "keyword" (FTS5), "semantic" (vector), or "hybrid" (both, default). limit: Max results (default 10).

Returns rich results with path, score, title, type, confidence, tags, and snippet.

Find all notes that contain a [[wikilink]] to the given path.

Args: path: Target note path.

Explore the link graph around a note via BFS traversal.

Args: start: Starting note path. depth: How many hops to follow (default 2). direction: "forward" (outgoing links), "backward" (incoming), or "both".

Returns nodes with depth and directed edges (source → target).

Check vault health: find dead [[wikilinks]] and orphan notes with no connections.