2.1 KiB
2.1 KiB
title, type, tags, last_updated, sources
| title | type | tags | last_updated | sources | |||||
|---|---|---|---|---|---|---|---|---|---|
| Obsidian-CLI | concept |
|
2026-04-16 |
|
Definition
Obsidian-CLI 是 Obsidian v1.12+ 内置的官方命令行工具，让用户能够从终端完全控制 Obsidian 的所有功能。CLI 提供两种使用模式：单命令模式（obsidian <command>）和 TUI 交互模式（obsidian 进入交互终端，支持自动补全和命令历史）。通过标准化的命令接口，AI Agent 可以实现笔记增删改查、日记管理、任务操作、搜索、书签、热键管理、文件版本对比等全部 GUI 功能，无需图形界面即可完成复杂的知识管理工作。
核心能力
- 日常操作：daily（日记）、search（搜索）、read（读取）、create（创建）、tags（标签）、tasks（任务）、bookmarks（书签）
- 文件管理：append/prepend（追加/前置内容）、move/rename（移动/重命名）、delete（删除）
- 插件管理：plugin:enable/disable/reload（启用/禁用/热重载插件）
- 属性操作：property:set/remove/read（设置/删除/读取属性）
- 开发者命令：devtools、dev:screenshot、dev:console、eval（执行 JS）、plugin:reload（热重载社区插件）
- 版本管理：diff（版本对比）、history:restore（历史恢复）、sync:restore（Sync 恢复）
- 工作区管理：workspace:save/load（保存/加载布局）、tabs（标签页管理）
Configuration Steps
- 确认 Obsidian 客户端版本 ≥ 1.12
- 打开"设置 → 常规 (General)"
- 找到"命令行界面 (Command line interface)"开关并打开
- 在弹窗中确认注册到系统 Path
- 确保 Obsidian 客户端处于运行状态（未运行时系统会自动启动）
Verification
obsidian daily
配置正确则 Obsidian 会自动应用日记模版并生成今日日记文件。
Requirements
- Obsidian ≥ 1.12
- CLI 开关已开启
- Obsidian 客户端运行中
Connections
- kepano — obsidian-cli 的发布者
- obsidian-必装-skills — 来源文档
- Obsidian — CLI 所操作的笔记软件