Read personal notes from the local filesystem.

If no filename is provided, lists all available notes with metadata. If a filename is provided, returns the full content of that note.

Args: filename: Optional. Name of the note file to read (e.g. "ideas.md"). If omitted, returns a list of all available notes.

Returns: JSON string with note content or list of available notes.

Search personal notes and files by semantic meaning.

Uses vector embeddings to find content related to your query, even if the exact words don't match. For example, searching "project deadlines" will find notes about "due dates" or "milestones".

Args: query: Natural language description of what you're looking for. top_k: Number of results to return (1-20, default 5).

Returns: JSON string with ranked search results and relevance scores.

Get recent file system activity from watched directories.

Shows the latest file changes (created, modified, deleted, moved) in your notes and files directories. Useful for understanding what you've been working on recently.

Args: limit: Number of recent events to return (default 20, max 100).

Returns: JSON string with recent file events and timestamps.

Get statistics about the vector search index.

Shows how many documents/chunks are indexed, which embedding model is being used, and where the data is stored.

Returns: JSON string with index statistics.

Save a new note or overwrite an existing one.

Use this to write memories, meeting summaries, conversation notes, or any context back into the personal knowledge base.

Args: filename: Name for the note file (e.g., "meeting-summary.md"). content: Full content to write.

Returns: JSON string with saved file metadata.

Append content to an existing note.

Use this to add follow-up context, action items, or updates to an existing note without overwriting it.

Args: filename: Name of the existing note file. content: Content to append.

Returns: JSON string with updated file metadata.