Skip to content
Back to search

obsidian-cli-skill

MarketplaceWorks with Claude CodeGitHub

Obsidian CLI skill for Claude Code — interact with Obsidian vaults from the terminal

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pablo-mano--obsidian-cli-skill/badge.svg)](/listings/pablo-mano--obsidian-cli-skill)

HTML

<a href="/listings/pablo-mano--obsidian-cli-skill"><img src="/api/listings/pablo-mano--obsidian-cli-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code — Plugin (native)

**Option A — Marketplace install (recommended):**

/plugin marketplace add https://github.com/pablo-mano/Obsidian-CLI-skill
/plugin install obsidian-cli

Done — see [Invoking the Skill](#invoking-the-skill) above for how to activate it.

**Option B — Direct plugin load:**

1. Clone this repository:

   git clone https://github.com/pablo-mano/Obsidian-CLI-skill

2. Load the plugin with the `--plugin-dir` flag:

   claude --plugin-dir ./Obsidian-CLI-skill

**Option C — Persistent via `settings.json`:**

Add to your project's `.claude/settings.json`:

{
  "plugins": {
    "obsidian-cli": {
      "source": { "source": "github", "repo": "pablo-mano/Obsidian-CLI-skill" }
    }
  }
}

> The `.claude-plugin/marketplace.json` manifest makes this repository compatible with Claude Code's marketplace system.

---

Cursor

Cursor has a native skills system (launched Feb 2026) that is directly compatible with the `SKILL.md` format — no rules file needed.

In a terminal:

git clone --depth 1 https://github.com/pablo-mano/Obsidian-CLI-skill /tmp/Obsidian-CLI-skill
mkdir -p ~/.cursor/skills
cp -r /tmp/Obsidian-CLI-skill/skills/obsidian-cli ~/.cursor/skills/obsidian-cli
rm -rf /tmp/Obsidian-CLI-skill

Cursor picks it up automatically — no restart needed.

---

Cortex Code

**Option A — Remote install (recommended)**

In a Cortex Code session, run:

/skill add https://github.com/pablo-mano/Obsidian-CLI-skill.git

Cortex Code clones the repo and caches the skill. Use `/skill sync obsidian-cli` to pull updates later.

**Option B — Project-local install**

mkdir -p .cortex/skills/obsidian-cli
curl -sSL https://raw.githubusercontent.com/pablo-mano/Obsidian-CLI-skill/main/skills/obsidian-cli/SKILL.md \
  -o .cortex/skills/obsidian-cli/SKILL.md

Or clone the repo and copy:

git clone https://github.com/pablo-mano/Obsidian-CLI-skill.git /tmp/obsidian-cli-skill
cp -r /tmp/obsidian-cli-skill/skills/obsidian-cli .cortex/skills/

**Option C — User-level install**

mkdir -p ~/.snowflake/cortex/skills/obsidian-cli
cp skills/obsidian-cli/SKILL.md ~/.snowflake/cortex/skills/obsidian-cli/

**Verify**

/skill list

You should see `obsidian-cli` in the output.

**Invoke**

Prefix requests with `$obsidian-cli` or just describe what you want — Cortex Code activates the skill automatically when the context matches:

$obsidian-cli append to today's daily note: "Reviewed Snowflake PR #42"

---

GitHub Copilot (VS Code)

Copilot supports [custom instructions](https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot) via repository files:

**Option A — Repository-wide (recommended):** 1. Create `.github/copilot-instructions.md` in your repo. 2. Paste the body of `SKILL.md` into the file.

**Option B — Path-scoped:** 1. Create `.github/instructions/obsidian-cli.instructions.md` 2. Add frontmatter `applyTo: "**/*"` then paste the `SKILL.md` body.

---

Windsurf

Windsurf uses a Rules system (`.windsurf/rules/`). Rules have a 12,000 character limit per file, so split the skill across two files:

1. Create `.windsurf/rules/obsidian-cli.md` — paste the body of `SKILL.md` (everything after the `---` frontmatter). 2. Create `.windsurf/rules/obsidian-cli-reference.md` — paste the contents of `skills/obsidian-cli/references/command-reference.md`.

Set the activation mode to **Always On** or **Model Decision** in each file's frontmatter to control when the rules apply.

---

Nanoclaw

Nanoclaw loads skills from `.claude/skills/` using the same `SKILL.md` format — directly compatible.

1. Clone or download this repo 2. Copy the skill folder into your Nanoclaw project:

   cp -r Obsidian-CLI-skill /path/to/nanoclaw/.claude/skills/obsidian-cli

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "obsidian-cli-skill",
  4. "description": "Obsidian CLI skill for Claude Code — interact with Obsidian vaults from the terminal",
  5. "owner": {
  6. "name": "pablo-mano"
  7. },
  8. "plugins": [
  9. {
  10. "name": "obsidian-cli",
  11. "description": "Interact with Obsidian vaults using the official Obsidian CLI (v1.12+). Read, create, append, search, and manage notes, daily notes, properties, tags, tasks, bookmarks, templates, themes, sync, plugins, and links — all from the terminal.",
  12. "author": {
  13. "name": "pablo-mano"
  14. },
  15. "source": "./plugins/obsidian-cli",
  16. "category": "productivity",
  17. "homepage": "https://github.com/pablo-mano/Obsidian-CLI-skill"
  18. }
  19. ]
  20. }
README.md · README · 312 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Obsidian CLI — Claude Code Skill
  2. A skill for AI coding agents that enables full control of [Obsidian](https://obsidian.md) vaults from the terminal using the official **Obsidian CLI** (v1.12+).
  3. ![Version](https://img.shields.io/badge/skill-v1.3.0-CC785C)
  4. ![Obsidian](https://img.shields.io/badge/Obsidian-v1.12%2B-7C3AED?logo=obsidian&logoColor=white)
  5. ![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-D97757)
  6. ![Claude Code Plugin](https://img.shields.io/badge/Anthropic-Compatible-CC785C)
  7. ---
  8. ## What This Skill Does
  9. Once installed, your AI agent will know how to interact with Obsidian vaults through the official CLI — reading, creating, and editing notes; managing daily notes; running full-text search; querying tasks, tags, links, and properties; managing plugins and sync; and running developer tools.
  10. Covers **130+ commands** across all major areas:
  11. | Area | Commands |
  12. |---|---|
  13. | **Files** | `read`, `create`, `append`, `prepend`, `move`, `rename`, `delete`, `files`, `folders`, `file`, `random` |
  14. | **Daily Notes** | `daily`, `daily:read`, `daily:append`, `daily:prepend`, `daily:path` |
  15. | **Search** | `search`, `search:context` with scoping, limits, JSON output |
  16. | **Properties** | `properties`, `property:read`, `property:set`, `property:remove`, `aliases` |
  17. | **Tags** | `tags`, `tag` with counts and filtering |
  18. | **Tasks** | `tasks`, `task` — query, filter, toggle |
  19. | **Links** | `backlinks`, `links`, `unresolved`, `orphans`, `deadends` |
  20. | **Bookmarks** | `bookmarks`, `bookmark` |
  21. | **Templates** | `templates`, `template:read`, `template:insert` |
  22. | **Plugins** | `plugins`, `plugin`, `plugin:enable/disable/install/uninstall`, `plugins:restrict` |
  23. | **Sync** | `sync`, `sync:status`, `sync:history`, `sync:read`, `sync:restore`, `sync:deleted` |
  24. | **Themes** | `themes`, `theme`, `theme:set`, `theme:install/uninstall` |
  25. | **Snippets** | `snippets`, `snippets:enabled`, `snippet:enable/disable` |
  26. | **Commands** | `commands`, `command`, `hotkeys`, `hotkey` |
  27. | **Bases** | `bases`, `base:query`, `base:views`, `base:create` |
  28. | **History** | `history`, `history:list`, `history:read`, `history:restore` |
  29. | **Workspace** | `workspace`, `tabs`, `tab:open` |
  30. | **Diff** | `diff` |
  31. | **Developer** | `eval`, `dev:screenshot`, `dev:debug`, `dev:console`, `dev:errors`, `dev:css`, `dev:dom`, `devtools` |
  32. | **Vault** | `vault`, `vaults`, `version`, `reload`, `restart`, `recents`, `outline`, `wordcount` |
  33. ---
  34. ## Invoking the Skill
  35. The skill activates automatically when your request clearly involves Obsidian vault operations. For casual phrasing, you may need to invoke it explicitly:
  36. | Method | Example |
  37. |---|---|
  38. | **Natural language** (usually works) | *"add this to my daily note: …"*, *"search my vault for X"* |
  39. | **Explicit prefix** (always works) | `$obsidian-cli append to today's daily note: "…"` |
  40. | **Strict mode** (always active) | Enable in Claude Code settings so the skill is always loaded |
  41. If Claude tries to answer a vault request without executing any commands, just say `use obsidian-cli` and it will retry with the skill active.
  42. ---
  43. ## Prerequisites
  44. > Obsidian v1.12 is available to **all users** — no Early Access build or Catalyst license required.
  45. | Requirement | Details |
  46. |---|---|
  47. | **Obsidian Desktop** | v1.12.0+ |
  48. | **CLI enabled** | Settings → Command line interface → Toggle ON |
  49. | **Obsidian running** | The desktop app must be running — the CLI communicates over IPC |
  50. ### Platform notes
  51. - **macOS / Linux** — the `obsidian` binary is added to PATH automatically when you enable CLI in settings.
  52. - **Windows** — requires an `Obsidian.com` redirector file placed alongside `Obsidian.exe`. Must run from a **normal-privilege terminal** — admin terminals produce silent failures.
  53. - **Headless Linux** — use the `.deb` package (not snap). Run under `xvfb` and prefix commands with `DISPLAY=:5`. Set `PrivateTmp=false` if running as a systemd service.
  54. ---
  55. ## Installation
  56. ### Claude Code — Plugin (native)
  57. **Option A — Marketplace install (recommended):**
  58. ```
  59. /plugin marketplace add https://github.com/pablo-mano/Obsidian-CLI-skill
  60. /plugin install obsidian-cli
  61. ```
  62. Done — see [Invoking the Skill](#invoking-the-skill) above for how to activate it.
  63. **Option B — Direct plugin load:**
  64. 1. Clone this repository:
  65. ```bash
  66. git clone https://github.com/pablo-mano/Obsidian-CLI-skill
  67. ```
  68. 2. Load the plugin with the `--plugin-dir` flag:
  69. ```bash
  70. claude --plugin-dir ./Obsidian-CLI-skill
  71. ```
  72. **Option C — Persistent via `settings.json`:**
  73. Add to your project's `.claude/settings.json`:
  74. ```json
  75. {
  76. "plugins": {
  77. "obsidian-cli": {
  78. "source": { "source": "github", "repo": "pablo-mano/Obsidian-CLI-skill" }
  79. }
  80. }
  81. }
  82. ```
  83. > The `.claude-plugin/marketplace.json` manifest makes this repository compatible with Claude Code's marketplace system.
  84. ---
  85. ### Cursor
  86. Cursor has a native skills system (launched Feb 2026) that is directly compatible with the `SKILL.md` format — no rules file needed.
  87. In a terminal:
  88. ```bash
  89. git clone --depth 1 https://github.com/pablo-mano/Obsidian-CLI-skill /tmp/Obsidian-CLI-skill
  90. mkdir -p ~/.cursor/skills
  91. cp -r /tmp/Obsidian-CLI-skill/skills/obsidian-cli ~/.cursor/skills/obsidian-cli
  92. rm -rf /tmp/Obsidian-CLI-skill
  93. ```
  94. Cursor picks it up automatically — no restart needed.
  95. ---
  96. ### Cortex Code
  97. **Option A — Remote install (recommended)**
  98. In a Cortex Code session, run:
  99. ```
  100. /skill add https://github.com/pablo-mano/Obsidian-CLI-skill.git
  101. ```
  102. Cortex Code clones the repo and caches the skill. Use `/skill sync obsidian-cli` to pull
  103. updates later.
  104. **Option B — Project-local install**
  105. ```bash
  106. mkdir -p .cortex/skills/obsidian-cli
  107. curl -sSL https://raw.githubusercontent.com/pablo-mano/Obsidian-CLI-skill/main/skills/obsidian-cli/SKILL.md \
  108. -o .cortex/skills/obsidian-cli/SKILL.md
  109. ```
  110. Or clone the repo and copy:
  111. ```bash
  112. git clone https://github.com/pablo-mano/Obsidian-CLI-skill.git /tmp/obsidian-cli-skill
  113. cp -r /tmp/obsidian-cli-skill/skills/obsidian-cli .cortex/skills/
  114. ```
  115. **Option C — User-level install**
  116. ```bash
  117. mkdir -p ~/.snowflake/cortex/skills/obsidian-cli
  118. cp skills/obsidian-cli/SKILL.md ~/.snowflake/cortex/skills/obsidian-cli/
  119. ```
  120. **Verify**
  121. ```
  122. /skill list
  123. ```
  124. You should see `obsidian-cli` in the output.
  125. **Invoke**
  126. Prefix requests with `$obsidian-cli` or just describe what you want — Cortex Code activates
  127. the skill automatically when the context matches:
  128. ```
  129. $obsidian-cli append to today's daily note: "Reviewed Snowflake PR #42"
  130. ```
  131. ---
  132. ### GitHub Copilot (VS Code)
  133. Copilot supports [custom instructions](https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot) via repository files:
  134. **Option A — Repository-wide (recommended):**
  135. 1. Create `.github/copilot-instructions.md` in your repo.
  136. 2. Paste the body of `SKILL.md` into the file.
  137. **Option B — Path-scoped:**
  138. 1. Create `.github/instructions/obsidian-cli.instructions.md`
  139. 2. Add frontmatter `applyTo: "**/*"` then paste the `SKILL.md` body.
  140. ---
  141. ### Windsurf
  142. Windsurf uses a Rules system (`.windsurf/rules/`). Rules have a 12,000 character limit per file, so split the skill across two files:
  143. 1. Create `.windsurf/rules/obsidian-cli.md` — paste the body of `SKILL.md` (everything after the `---` frontmatter).
  144. 2. Create `.windsurf/rules/obsidian-cli-reference.md` — paste the contents of `skills/obsidian-cli/references/command-reference.md`.
  145. Set the activation mode to **Always On** or **Model Decision** in each file's frontmatter to control when the rules apply.
  146. ---
  147. ### Nanoclaw
  148. Nanoclaw loads skills from `.claude/skills/` using the same `SKILL.md` format — directly compatible.
  149. 1. Clone or download this repo
  150. 2. Copy the skill folder into your Nanoclaw project:
  151. ```bash
  152. cp -r Obsidian-CLI-skill /path/to/nanoclaw/.claude/skills/obsidian-cli
  153. ```
  154. 3. The skill is available as a slash command (`/obsidian-cli`) or auto-triggers when you ask the agent to interact with Obsidian.
  155. > This is a knowledge skill — it adds Obsidian CLI awareness to the agent without modifying Nanoclaw's codebase.
  156. ---
  157. ### Openclaw
  158. Openclaw loads skills from the `skills/` directory at the project root using the `SKILL.md` format — directly compatible.
  159. 1. Clone or download this repo
  160. 2. Copy the skill folder into Openclaw's skills directory:
  161. ```bash
  162. cp -r Obsidian-CLI-skill /path/to/openclaw/skills/obsidian-cli
  163. ```
  164. 3. Restart the Openclaw agent — skills are discovered automatically.
  165. ---
  166. ### Any Other LLM Agent or Assistant
  167. `SKILL.md` is a plain Markdown document. For any agent that supports custom system prompts or instructions:
  168. 1. Open the agent's system prompt / custom instructions settings.
  169. 2. Paste the contents of `SKILL.md` (with or without the YAML frontmatter — most agents accept either).
  170. 3. Optionally include `skills/obsidian-cli/references/command-reference.md` for the complete command reference.
  171. This works with any chat interface or coding agent that has a system prompt or custom instructions field.
  172. ---
  173. ## Quick Examples
  174. ### Append to today's daily note
  175. ```bash
  176. obsidian daily:append content="- [ ] Review pull requests"
  177. ```
  178. ### Search your vault and pipe to jq
  179. ```bash
  180. obsidian search query="meeting notes" format=json | jq '.[].path'
  181. ```
  182. ### Vault health check
  183. ```bash
  184. obsidian files total # Total file count
  185. obsidian tags counts sort=count # Most-used tags
  186. obsidian tasks # All open tasks
  187. obsidian orphans # Notes with no links
  188. obsidian unresolved # Broken wikilinks
  189. ```
  190. ### Create a note from a template with metadata
  191. ```bash
  192. obsidian create path="projects/new-feature" template="project-template"
  193. obsidian property:set path="projects/new-feature.md" name="status" value="planning"
  194. obsidian property:set path="projects/new-feature.md" name="created" value="$(date -I)"
  195. obsidian daily:append content="- Started [[projects/new-feature|New Feature]]"
  196. ```
  197. ---
  198. ## Full Command Reference
  199. See [`skills/obsidian-cli/references/command-reference.md`](skills/obsidian-cli/references/command-reference.md) for the complete reference covering all commands, parameters, flags, output formatting, multi-vault usage, and headless Linux setup.
  200. ---
  201. ## Troubleshooting
  202. | Problem | Cause | Fix |
  203. |---|---|---|
  204. | Empty output / hangs | Obsidian not running, or admin terminal (Windows) | Start Obsidian; use a normal-privilege terminal |
  205. | `command not found` | CLI not registered in PATH | Re-enable CLI in Settings; restart terminal |
  206. | Unicode errors | Bug fixed in v1.12.2+ | Update Obsidian |
  207. | Wrong vault targeted | Multi-vault ambiguity | Pass vault name as the first argument: `obsidian "My Vault" ...` |
  208. | IPC socket not found (Linux) | `PrivateTmp=true` in systemd unit | Set `PrivateTmp=false` |
  209. | Snap confinement errors | Snap restricts IPC | Use the `.deb` package instead |
  210. | Multi-vault `"Name" command` fails | Vault name matching issue | Omit vault name; switch vault manually in Obsidian UI |
  211. | `property:set` list value is a string | CLI stores value as-is | Edit frontmatter directly or use `eval` to call Obsidian API |
  212. | Colon+params exit 127 (missing `.com`) | Outdated installer — `Obsidian.com` absent | Reinstall from [obsidian.md/download](https://obsidian.md/download) |
  213. | Colon+params exit 127 (Git Bash / MSYS2) | Bash resolves `obsidian` to `.exe` not `.com` | Create `~/bin/obsidian` wrapper: `#!/bin/bash` + `/c/path/to/Obsidian.com "$@"`, add `export PATH="$HOME/bin:$PATH"` to `~/.bashrc` |
  214. ---
  215. ## License
  216. This skill is provided as-is for use with the Obsidian CLI. Obsidian v1.12+ is free for all users.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.