用途:在终端中操作 Obsidian 仓库,包括笔记读写、搜索、属性(frontmatter)、链接、任务、Bases 以及插件开发调试。
两个 CLI:obsidian 应用 CLI(主选,功能更全)与 notesmd-cli(当 obsidian 不可用时的文件系统回退方案)。没有单独的调用模式,选择环境中存在的二进制即可。若 obsidian 在 PATH 中,所有工作流都用它;若缺失但 notesmd-cli 在 PATH 中,按 notesmd-fallback.md 做无头仓库操作;两者都没有则说明情况,改用直接编辑文件、MCP 或用户提供的其他工具。
可用性检查:环境未知时先用 command -v obsidian 和 command -v notesmd-cli(或 which)确认安装,不要假设存在。沙箱内 obsidian 找不到运行中的应用时,先在沙箱外重试再回退。
用法:运行 obsidian <command> 控制正在运行的实例,多数命令要求应用已运行,首条命令会自动启动。用 obsidian help 或 obsidian help <command> 获取最新命令参考。参数用 param=value,含空格需加引号;布尔标志 silent、overwrite、newtab 无值;多行内容用 \n、\t。仓库用 vault=<name>(默认 cwd 或活动仓库),文件用 file=<name>(按 wikilink 解析)或 path=<path>。无参数运行进入交互 TUI。
主要能力:search、search:context、links、backlinks、outline、orphans、deadends、unresolved、tags、tag;read、create、append、prepend、move、rename、delete;daily:read、daily、daily:append、daily:prepend、daily:path;tasks、task;properties、property:read/set/remove;bases、base:views、base:query、base:create;插件开发用 plugin:reload、dev:errors、dev:screenshot、dev:dom、dev:console、eval、dev:css、dev:mobile。
限制:多数命令依赖运行中的 Obsidian 实例;notesmd-cli 仅作回退;具体安装方式、平台支持与收费信息暂未提供。