obsidian

Manage Obsidian vaults and automate Markdown notes via obsidian-cli.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill obsidian-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/obsidian
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill obsidian-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires obsidian-cli.

What problem does it solve? Working with Obsidian notes from scripts or AI agents 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: Reads ~/Library/Application Support/obsidian/obsidian.json or uses 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: Ask the agent to rename a project note and reorganize it into an archive folder; all backlinks across your vault stay intact. ## Quick Start Find my default Obsidian vault and create a new note called "Meeting Notes" in the Work folder with a short agenda.

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 path 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 marked with `"open": true`.

How do I search inside Obsidian notes from a script?

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

Does renaming an Obsidian note break wikilinks?

Renaming with plain `mv` breaks links, but `obsidian-cli move "old/path" "new/path"` updates `[[wikilinks]]` and common Markdown links across the entire vault automatically. This is the main advantage over direct file operations.

Can I edit Obsidian notes directly as Markdown files?

Yes, Obsidian notes are plain Markdown files on disk, so you can edit them with any editor or script and Obsidian picks up the changes. Avoid touching the `.obsidian/` config folder from scripts.

Why does obsidian-cli fail to create a note in a dot-folder?

Note creation goes through the Obsidian URI handler (`obsidian://...`), which requires Obsidian to be installed and may refuse paths under hidden dot-folders like `.something/`. Create notes in regular folders instead.