obsidian-vault-manager

Manage Obsidian vaults and notes with a local registry.

10|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/eugenepyvovarov/obsidian-agent-skill --skill obsidian-vault-manager-eugenepyvovarov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault-manager
Source: https://github.com/eugenepyvovarov/obsidian-agent-skill/tree/main
Command: npx skills add https://github.com/eugenepyvovarov/obsidian-agent-skill --skill obsidian-vault-manager-eugenepyvovarov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides a centralized way to manage local Obsidian vaults and perform common note operations (registering vaults, tracking an active vault and a working folder, and editing/searching notes with fast text search).

Core Features & Use Cases

  • Discover, register, and switch between multiple Obsidian vaults within a project.
  • Set an active vault and a default working folder to constrain edits and searches.
  • Create, edit, refactor, search, and organize notes, frontmatter, links, tags, and attachments while preserving frontmatter integrity.

Quick Start

Use the vault_registry tool to discover, register, and manage vaults with commands like:

  • Register a vault: python3 scripts/vault_registry.py add --path "/path/to/Vault" --name "Vault"
  • Discover vaults: python3 scripts/vault_registry.py discover --merge
  • List vaults: python3 scripts/vault_registry.py list
  • Set active vault: python3 scripts/vault_registry.py set-active --name "Vault"

Frequently Asked Questions about obsidian-vault-manager

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

FAQPage Schema
How do I manage multiple Obsidian vaults from a single project?

You can manage multiple Obsidian vaults by discovering, registering, and switching between them using a local registry script. It tracks an active vault and a working folder to constrain edits and searches within the project.

How do I constrain Obsidian note searches to a specific working folder?

To constrain Obsidian note searches, set a default working folder within an active vault. This isolates fast text search and edits to a specific directory, preserving frontmatter integrity and preventing modifications outside the designated area.

Can I automate Obsidian vault registration and notes scripting?

Yes, you can automate Obsidian vault registration and notes scripting by executing local Python commands. The script allows adding vault paths, merging discovered directories, and setting active environments without manual GUI interaction.

Does this approach preserve frontmatter when editing markdown notes?

Yes, editing markdown notes through this method preserves frontmatter integrity. It safely handles refactoring, organizing tags, links, and attachments while maintaining the original metadata structure at the top of your files.

What are the limitations of using a local registry for Obsidian vaults?

The local registry enforces strict isolation to the skill root and project data directory. Operations are constrained to registered paths, meaning editing or searching outside the active vault's working folder is restricted by design.

How do I discover and register existing Obsidian vaults on my system?

To discover and register existing Obsidian vaults, run the discovery command with a merge flag to scan for directories. You then add specific paths to the local registry to activate them for note management.