obsidian

Manage Obsidian vaults on disk using obsidian-cli tooling.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/PotLock/foxfang --skill obsidian-potlock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/PotLock/foxfang/tree/main/skills/obsidian
Command: npx skills add https://github.com/PotLock/foxfang --skill obsidian-potlock

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vaults are folders on disk, and managing multiple vaults (finding the active one, navigating their structure, and coordinating note edits) can be tedious. A vault typically contains notes as Markdown files, a .obsidian directory for workspace and plugin settings, canvases in JSON format, and attachments stored in a chosen folder.

Core Features & Use Cases

  • Identify active vaults on disk and read vault configurations
  • Use obsidian-cli to search notes, create notes, and move/rename notes across vaults
  • Use case: manage separate work and personal vaults from a single command-line workflow

Quick Start

Set a default vault with obsidian-cli and begin searching or creating notes.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I manage multiple Obsidian vaults from the command line?

Obsidian-cli integration enables locating active vault directories on disk, reading vault configurations, and executing markdown note searches or cross-vault note creation and moves.

How do I search markdown notes in an Obsidian vault without opening the app?

Executing obsidian-cli search commands against the vault directory on disk retrieves markdown notes without opening the Obsidian application interface.

Do I need obsidian-cli installed to automate vault management?

Yes, automating vault management requires installing obsidian-cli and ensuring read or write access to the target vault directories on disk to execute note operations.

Can I move notes between separate work and personal Obsidian vaults?

Executing obsidian-cli move commands transfers markdown notes between separate work and personal Obsidian vault directories while preserving the file structure on disk.

What is the structure of an Obsidian vault that I need to know for automation?

An Obsidian vault on disk contains markdown notes, a .obsidian directory for workspace settings, JSON canvas files, and an attachments folder for referenced media.