obsidian

Read, search, and manage Obsidian vault notes from the command line.

97|8|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/peteromallet/megaplan --skill obsidian-peteromallet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/peteromallet/megaplan/tree/main/megaplan/agent/skills/note-taking/obsidian
Command: npx skills add https://github.com/peteromallet/megaplan --skill obsidian-peteromallet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vault note management via shell: read, search, and write notes without a GUI.

Core Features & Use Cases

  • Read a note by path or name
  • List all notes in the vault
  • Search notes by filename or content
  • Create or append to notes
  • Navigate and link notes using Obsidian Wikilinks

Quick Start

Set OBSIDIAN_VAULT_PATH to your vault location and start reading, listing, and creating notes from the terminal.

Frequently Asked Questions about obsidian

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

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

You can search and read Obsidian vault notes from the command line by setting the OBSIDIAN_VAULT_PATH environment variable, which allows you to list, find, and open markdown files without a GUI.

Can I create and append text to markdown notes in an Obsidian vault via shell?

Yes, you can create and append text to markdown notes in an Obsidian vault via shell using simple file operations, writing directly to the path defined by the OBSIDIAN_VAULT_PATH environment variable.

Do I need the Obsidian GUI running to search vault content by filename or text?

No, you do not need the Obsidian GUI running to search vault content by filename or text. The tool performs direct file operations on your markdown vault path without any GUI dependencies.

What is the best way to manage Obsidian notes without opening the desktop app?

The best way to manage Obsidian notes without opening the desktop app is using a command line tool to read, search, and write markdown files directly within your configured vault directory.

How do I handle spaces in file paths when reading notes in an Obsidian vault?

To handle spaces in file paths when reading notes in an Obsidian vault, the command line tool applies path quoting to ensure simple file operations locate and read the correct markdown files.

Does this tool support navigating and linking notes using Obsidian Wikilinks?

Yes, the tool supports navigating and linking notes using Obsidian Wikilinks, allowing you to manage connections between markdown files while reading, searching, and creating notes from the terminal.