用途：在不启动 Obsidian 应用的前提下，通过两个命令行工具统一操作 Obsidian 笔记库（vault）。qmd 负责搜索，notesmd-cli 负责笔记的增删改查等操作。
安装与初始化：qmd 可通过 npm i -g @anthropic/qmd 安装或检查 which qmd；notesmd-cli 通过 brew install yakitrak/yakitrak/notesmd-cli 安装。先用 notesmd-cli set-default "VaultName" 设置默认库，再用 qmd collection add ~/path/to/vault --name vault --mask "**/*.md" 建立索引，并用 qmd embed 生成向量嵌入。用 notesmd-cli print-default 和 qmd status 验证。索引维护用 qmd update 与 qmd embed。
主要能力：搜索方面，qmd search 为关键词搜索，qmd vsearch 为语义搜索，qmd query 为混合搜索（质量最佳）；支持 --json、--md、-n、--full 等输出选项。笔记方面，notesmd-cli create 支持 --content、--append、--overwrite（后两者互斥），print 读取，move 移动或重命名并自动更新全库 wikilink 与 markdown 链接，delete 为永久删除且不更新其他文件的引用，daily 处理日记笔记，fm 处理 frontmatter 的查看、编辑与删除，print --mentions 显示反向链接，list 列出文件。
使用方式与限制：notesmd-cli 没有局部编辑功能，只能追加或覆盖；需要精确修改时应先用 notesmd-cli print 读取内容，再通过 notesmd-cli print-default --path-only 解析库路径后用编辑工具按完整路径修改，不要硬编码路径。模板通过 meta/templates/ 下的普通 markdown 文件加 cp 实现，无 --template 标志；日记模板路径在 .obsidian/daily-notes.json 配置。删除操作不可撤销。该方案可用于构建 AI 代理记忆：用 notesmd-cli 写入记忆笔记，用 qmd vsearch 或 qmd query 检索上下文，用 qmd multi-get 批量获取；更多检索模式与代理记忆流程见 references/search.md 与 references/agent-memory.md。