obsidian

Search, read, create, and edit notes in an Obsidian vault via CLI commands.

Updated May 3, 2017
One-click install
npx skills add https://github.com/arnonmoscona/dot_files --skill obsidian-arnonmoscona
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/arnonmoscona/dot_files/tree/main/wsl/.claude/skills/obsidian
Command: npx skills add https://github.com/arnonmoscona/dot_files --skill obsidian-arnonmoscona

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Accessing and updating Obsidian notes from an AI assistant normally requires manual copy-paste or switching apps. This Skill lets the assistant search, read, create, and append notes directly in your Obsidian vault through the obsidian CLI, including your claude-global-memory notes shared across projects. ## Core Features & Use Cases - Search and Read: Run full-text searches across the vault or a subfolder, and read notes by fuzzy name match or exact relative path. - Create and Append: Create new notes with Markdown content or append sections to existing notes, with inline append support. - Vault Navigation: List vaults and enumerate files in folders such as claude-global-memory. - Use Case: Ask the assistant to save a decision from the current session as a global memory; it creates a new note under claude-global-memory/claude-global-memories/ so future sessions can retrieve it. ## Quick Start Ask the assistant to search your Obsidian vault for notes about a topic, for example: search my Obsidian global memories for everything about deployment configuration.

Frequently Asked Questions about obsidian

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

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

Run obsidian search with a query parameter, optionally adding a path parameter to limit results to a subfolder. Use search:context instead of search when you also need the matching lines displayed alongside file names.

How do I read an Obsidian note without knowing its full path?

Use obsidian read with the file parameter, which matches notes by name fuzzily, similar to wikilink resolution. If you know the exact location, pass the path parameter with the vault-relative path instead.

Does the obsidian CLI require the Obsidian app to be running?

Yes, Obsidian must be running for the CLI to work, but the first command auto-launches the application if it is not already open. Subsequent commands execute against the running instance.

How do I append content to an existing Obsidian note?

Use obsidian append with a path or file parameter and the content to add. By default the content is added on a new line; pass the inline flag to append without a leading newline.

What are the limitations of creating notes through the obsidian CLI?

The create command overwrites the file if it already exists, so use append when extending notes. Newlines in content must be written as literal \n escape sequences, and all paths are relative to the vault root.