Obsidian CLI + Claude Code：把笔记变成AI可编程接口 ​

核心就一句话：你描述意图，AI 执行命令。CLI 的诞生就是给 AI 用的，不是给人用的。

Obsidian CLI是什么？ ​

官方定义：Obsidian 的命令行接口，让你从终端控制笔记。

特点：

• 需要 Obsidian 应用运行（版本 ≥ 1.12.7）
• 支持 JSON/TSV/CSV 输出（方便 AI 解析）
• 所有 GUI 能做的，CLI 都能做

人用 vs AI用 ​

逻辑：人描述意图 → AI 翻译为 CLI 命令 → 执行得到结果

技能包结构 ​

obsidian-cli-skill/
├── SKILL.md          # 技能说明（核心）
├── commands/         # 命令模板
│   ├── daily.sh      # 日记操作
│   ├── tasks.sh      # 任务管理
│   └── search.sh     # 搜索
└── README.md         # 使用说明

SKILL.md 包含：可用命令清单、使用规范、常用工作流、错误处理、示例对话。

5个真实场景 ​

1. 快速捕获任务 ​

你说：在日记里加个任务：下午 3 点和设计团队开会。

Claude Code 执行：

obsidian daily:append content="- [ ] 下午 3 点和设计团队开会"

2. 查询今日任务 ​

你问：今天日记里有哪些任务？

Claude Code 直接返回结果。

3. 搜索 + 整理 ​

你说：搜索所有提到「公众号」的笔记，整理成列表。

Claude Code 找到 3 篇相关笔记，主动问：需要我帮你整理成汇总文档吗？

4. 批量设置属性 ​

你说：给所有公众号草稿加上「状态=写作中」属性。

Claude Code 循环执行 obsidian property:set。

5. 创建新内容 ​

你说：用项目计划模板创建一篇新笔记。

obsidian create name="项目计划" template="项目计划" open

安装三步走 ​

Step 1：启用 CLI ​

Obsidian 设置 → 常规 → 启用「命令行界面」

Step 2：注册 CLI ​

按提示注册（macOS 需输入密码创建符号链接）

Step 3：验证安装 ​

obsidian version        # 检查版本

Step 4：加载技能包 ​

claude -c "加载 ./obsidian-cli-skill/SKILL.md"

高级玩法 ​

与 Things 3 联动 ​

things todos --today | while read todo; do
  obsidian daily:append content="- [ ] $todo"
done

自动整理 inbox ​

obsidian search path="inbox" --format json | \
  claude -p "分类整理成周报" | \
  obsidian create name="周报-$(date +%Y-%m-%d)" template="周报"

发布前检查 ​

obsidian property:read name="状态" | grep "已发布"
obsidian publish:add changed

日记自动化 ​

obsidian daily:prepend content="# 今日重点\n\n"
obsidian daily:append content="\n## 任务\n\n- [ ] 检查邮件\n- [ ] 回复消息\n"

常见问题 ​

操作多个仓库？ ​

obsidian vault="工作" search query="项目"
obsidian vault="个人" daily

命令执行失败如何调试？ ​

obsidian version      # 检查 CLI 是否可用
obsidian vault info   # 检查当前仓库
obsidian files --total  # 测试文件访问

总结 ​

把重复的操作交给 AI，把创造力留给自己。

关键词：Obsidian CLI, Claude Code, 笔记自动化, SKILL.md, obsidian daily