obsidian

Read, search, create, and append Markdown notes in an Obsidian vault via shell commands.

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill obsidian-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill obsidian-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian knowledge base from an AI agent or terminal requires knowing the vault path and correct shell commands for reading, searching, and writing Markdown notes without opening the Obsidian app. ## Core Features & Use Cases - Read and list notes: Display note contents or enumerate all Markdown files in the vault or a specific subfolder. - Search by filename or content: Locate notes using find and grep across the vault. - Create and append notes: Write new Markdown notes or append content to existing ones, using [[wikilinks]] to connect related notes. - Use Case: Ask the agent to search your vault for meeting notes about a project, then append a summary of today's discussion to the relevant note. ## Quick Start Search my Obsidian vault for notes mentioning project roadmap and show me their contents.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search Obsidian notes from the command line?

Use find with -iname to search note filenames and grep -rli to search note contents across the vault directory. Both commands filter for .md files and work recursively through all subfolders.

How do I create a new Obsidian note from a script?

Write a Markdown file directly into the vault directory using cat with a heredoc or output redirection. Obsidian automatically detects new .md files placed in the vault folder.

Where is the Obsidian vault path configured?

Set the OBSIDIAN_VAULT_PATH environment variable, for example in ~/.hermes/.env. If unset, the skill defaults to ~/Documents/Obsidian Vault.

Why do Obsidian vault commands fail with spaces in the path?

Vault paths often contain spaces, such as the default Obsidian Vault folder name. Always wrap the vault path variable in double quotes so shell commands treat it as a single argument.

Can I link notes together when creating them programmatically?

Yes, use Obsidian's [[Note Name]] wikilink syntax inside the Markdown content. Obsidian resolves these links automatically when the vault is opened.