obsidian

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

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill obsidian-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/obsidian
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill obsidian-travis-burmaster

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, breaking 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 move it into an archive folder; all backlinks across the vault are updated automatically instead of breaking. ## Quick Start Use the obsidian skill to search my default vault for notes mentioning "quarterly planning" and show matching snippets.

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

How do I rename an Obsidian note without breaking wikilinks?

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.

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, which returns matching snippets with line context.

Can I edit Obsidian notes directly without obsidian-cli?

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

Why does creating a note with obsidian-cli fail in dot-folders?

Note creation relies on 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.