vaultctl

Search and manage Obsidian vault notes using the vaultctl CLI.

4|1|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/xtrm-dev/specialists --skill vaultctl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vaultctl
Source: https://github.com/xtrm-dev/specialists/tree/main/.xtrm/skills/default/vaultctl
Command: npx skills add https://github.com/xtrm-dev/specialists --skill vaultctl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually searching, reading, and updating notes inside an Obsidian vault, making it easy for an AI agent to work with local knowledge bases accurately and quickly.

Core Features & Use Cases

  • Vault Search: Find notes by keywords, folder, tag, status, or source using fast local indexing.
  • Note Management: Read, write, append, delete, and reindex notes with predictable CLI workflows.
  • Vault Operations: Inspect vault structure, check index health, audit duplicates or orphans, and expose the vault through MCP.
  • Use Case: A user asks for a buried research note, and the agent searches the vault, reads the best match, and updates it with new findings.

Quick Start

Use the vaultctl skill to search for the relevant note in your Obsidian vault, then read or update it with the command that matches the task.

Frequently Asked Questions about vaultctl

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

FAQPage Schema
How do I search Obsidian vault notes using an AI agent?

You can search Obsidian vault notes by using a CLI tool that applies SQLite FTS5 local indexing. This allows an AI agent to instantly find notes by keywords, folder, tag, or status without manual searching.

Can I read and update Obsidian notes directly from the command line?

Yes, you can read, write, append, and delete Obsidian notes directly from the command line. The CLI provides predictable workflows for note management, enabling agents to update buried research notes with new findings.

Does this note search method require a specific indexing database?

Yes, the note search requires SQLite FTS5 for fast local indexing. This ensures reliable full-text search capabilities and source-aware vault configuration for accurate agent operations across configured local vault sources.

What's the best way to audit an Obsidian vault for duplicate or orphaned notes?

The best way to audit an Obsidian vault is by using specific CLI operations to inspect vault structure and check index health. These commands identify duplicate or orphaned notes while exposing the vault through MCP.

Why use a CLI tool for Obsidian note management instead of manual editing?

Using a CLI tool for Obsidian note management removes the friction of manually searching and updating notes. It enables AI agents to work with local knowledge bases accurately and quickly, returning JSON output for reliable automation.