Productivity
obsidian-vault-manager avatar

obsidian-vault-manager

Manage Obsidian vaults, notes, and wiki-links using the Obsidian CLI. Perform safe note moves, fuzzy searches, daily note generation, and structured content management.

Introduction

The Obsidian Vault Manager is a specialized skill for interacting with Obsidian vaults via the native Obsidian CLI. It is designed for knowledge workers, developers, and researchers who use Obsidian for note-taking, documentation, or Zettelkasten systems. By providing direct access to vault operations, this skill ensures that structural changes—such as moving or renaming files—are handled correctly without breaking wiki-links or internal references. It functions as a bridge between your automated workflows and your static markdown files.

  • Perform vault-level operations including listing vaults, retrieving file paths, and exploring directory structures.

  • Execute link-safe note moving and renaming commands, ensuring all [[wiki-links]] are automatically updated to maintain knowledge integrity.

  • Streamline daily workflows with automated daily note creation and template-based file generation.

  • Support complex content retrieval using search queries with optional filtering by folder path or output formatting.

  • Enable structured data insertion by reading existing note frontmatter and formatting to ensure consistency across the vault.

  • Always verify the native 'obsidian' binary is installed before use; it is not an npm package.

  • Use the CLI specifically for structural operations (moving, renaming, listing). For writing substantial content, pair this tool with standard Write operations after resolving file paths.

  • When creating or appending content, utilize 'printf' or similar methods to correctly handle multi-line content, frontmatter, and newlines to prevent truncation.

  • Always inspect existing notes to mirror current local formatting, tag structures, and frontmatter requirements.

  • Use the specific 'obsidian move' command instead of standard shell 'mv' to preserve the integrity of internal vault links.

Repository Stats

Stars
11
Forks
1
Open Issues
1
Language
Shell
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 06:53 PM
View on GitHub