Obsidian CLI

🗃️ 知识库命令行中枢,笔记自动化引擎

官方 Obsidian CLI 工具,通过 IPC 连接运行中的 Obsidian 实例,实现笔记管理、任务追踪、搜索和自动化工作流。

收藏
13.6k
安装
3.5k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Obsidian CLI 是官方推出的命令行工具,为 Obsidian 知识库提供程序化控制能力。其核心架构基于 IPC(进程间通信),要求 Obsidian 1.12+ 版本并保持后台运行。

主要能力

笔记生命周期管理:支持创建、读取、更新、删除(CRUD)操作,可通过 wikilink 名称或精确路径定位文件,支持模板创建和批量追加/前置内容。

任务与日程:深度集成 Daily Notes,可提取、过滤(待办/已完成)、切换任务状态,支持跨 vault 的全局任务查询。

知识库导航:提供双向链接追踪(backlinks/outgoing)、孤儿文件检测、死链识别、大纲结构提取等图谱分析功能。

元数据操作:标签统计、属性读写、高级搜索(支持 JSON 输出和上下文匹配)。

开发者工具:JavaScript 代码执行、插件热重载、调试工具(截图、控制台、错误追踪)。

显著优点

  • 原生集成:官方出品,IPC 通信稳定可靠,无需第三方 API
  • 多 vault 支持:通过参数或工作目录自动识别目标库
  • 自动化友好:适合脚本、定时任务和 AI 工作流集成
  • Linux 深度适配:提供 Electron 沙盒问题的解决方案

局限性与风险

硬性依赖:必须保持 Obsidian GUI 运行,无法纯后台使用。Arch Linux 用户需额外配置 PrivateTmp=false 解决 IPC 权限问题。

安全边界eval 命令可执行任意 JavaScript,存在代码注入风险;截图/开发者工具暴露敏感界面内容。

平台差异:wrapper 脚本针对 Arch Linux 设计,其他发行版需自行适配 Electron 参数处理。

适用人群

高级用户、开发者、需要自动化笔记工作流的内容创作者,以及将 Obsidian 作为第二大脑进行量化管理的知识管理实践者。

常规风险提醒

  • 删除操作移至系统回收站,非永久删除
  • 多 vault 场景下务必显式指定 vault= 参数避免误操作
  • 非交互式使用前需确保 Obsidian 进程已启动

Obsidian CLI 内容

手动下载zip · 2.2 kB
SKILL.mdtext/markdown
请选择文件