obsidian

Manage Obsidian vaults and automate note operations via obsidian-cli.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/srgaba/open-claw --skill obsidian-srgaba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/obsidian
Command: npx skills add https://github.com/srgaba/open-claw --skill obsidian-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires obsidian-cli.

What problem does it solve? Working with Obsidian notes from scripts or the command line is error-prone when you guess vault paths or move files manually, which breaks wikilinks. This Skill shows how to locate the active vault from Obsidian's own config and use obsidian-cli to search, create, move, and delete notes safely. ## Core Features & Use Cases - Vault Discovery: Read ~/Library/Application Support/obsidian/obsidian.json or use obsidian-cli print-default to find the active vault instead of hardcoding paths. - Note Operations: Search note names and content, create notes with content, and delete notes via obsidian-cli commands. - Safe Refactoring: Move or rename notes with obsidian-cli move, which automatically updates [[wikilinks]] and Markdown links across the vault. - Use Case: You want to reorganize hundreds of notes into a new folder structure. Instead of mv (which breaks every link), use obsidian-cli move so all cross-references stay intact. ## Quick Start Find my default Obsidian vault and create a new note called "Meeting Notes/2024 Planning" with a short agenda, then search my vault for any notes mentioning "roadmap".

Frequently Asked Questions about obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find my active Obsidian vault from the command line?

Run `obsidian-cli print-default --path-only` if a default vault is set. Otherwise read `~/Library/Application Support/obsidian/obsidian.json` and use the vault entry with `"open": true`; the vault name is typically the folder name.

How do I rename or move Obsidian notes without breaking links?

Use `obsidian-cli move "old/path/note" "new/path/note"` instead of the `mv` command. It updates `[[wikilinks]]` and common Markdown links across the entire vault automatically, which is the main advantage over plain file moves.

How do I search inside Obsidian notes from the terminal?

Use `obsidian-cli search "query"` to match note names, or `obsidian-cli search-content "query"` to search inside note bodies. The content search returns matching snippets with line numbers.

Does obsidian-cli work without the Obsidian app installed?

Vault discovery and search work from the config file, but creating notes requires the Obsidian URI handler (`obsidian://…`), so the Obsidian desktop app must be installed. Direct edits to `.md` files also work since a vault is a plain folder.

Why does creating a note in a dot-folder fail in Obsidian?

Obsidian may refuse to create notes under hidden dot-folders (e.g. `.something/...`) when using the URI handler. Create notes in regular folders instead, or edit the Markdown file directly on disk.