用途：在用户的个人 Obsidian 库（iCloud 同步的 plain markdown 目录树）中查找、导航、阅读和编辑笔记，无需打开 Obsidian 应用。库路径为 /Users/fredrik/Library/Mobile Documents/iCloud~md~obsidian/Documents/personal，路径含空格和波浪号，shell 中须加引号，可先赋值 VAULT="/Users/fredrik/Library/Mobile Documents/iCloud~md~obsidian/Documents/personal"；若 $VAULT 不存在（非 mac 主机或 iCloud 尚未同步），应停止并告知用户，不要编造笔记。
主要能力：用 rg 和 fd（未安装则退回 grep/find）按文件名或全文检索笔记，始终排除 .obsidian/ 和 .trash/。常用命令：fd -tf 'pattern' "$VAULT" -E .obsidian -E .trash；rg --type md -n 'search term' "$VAULT" -g '!.obsidian' -g '!.trash'。可按标签或反链搜索，如 rg --type md -n '(^|\s)#X\b|tags:.*\bX\b'。
文件夹结构：Daily/（每日 YYYY-MM-DD.md）、Meeting notes/、Resources/（PARA 式参考）、Ideas/、Archive/、Clippings/、_templates/、_excalidraw/、.trash/（视为已删除）及若干顶层 md。笔记约定：每日笔记命名 Daily/YYYY-MM-DD.md，其他新建笔记前缀今日日期 YYYY-MM-DD-<title>.md；文件名可含空格和 emoji；每篇有 YAML frontmatter（id、aliases、tags、categories）；链接使用最短形式 wikilink，如 [[API design]]，不使用标准 markdown 链接。
使用方式：创建笔记时按意图选文件夹、复制 _templates/ 对应模板并替换 {{date}} 和 {{title}}；编辑时保留既有 frontmatter 与 wikilink 风格。偏好指引用户使用 obsidian.nvim 的快捷键或 :Obsidian 命令，配置见 nvim-fredrik/plugin/obsidian.lua。启用插件：frontmatter-generator 与 obsidian-excalidraw-plugin（_excalidraw/ 下的 .excalidraw.md 视为不透明）。限制：仅在 macOS 且 iCloud 已同步时可用；不适用于非 mac 主机；不要改动代码或命令。