Obsidian
Work with Obsidian vaults by searching, creating, moving, and editing Markdown notes -- with automatic wikilink refactoring via obsidian-cli.
by
Peter Steinberger
Obsidian Overview
The Obsidian skill gives your AI assistant full access to Obsidian vaults, which are plain Markdown folders on disk.
It can search notes, create new ones, move or rename files with automatic wikilink updates, and edit Markdown directly using obsidian-cli.
How It Works
Read Obsidian's vault configuration to locate active vaults, including multi-vault setups.
Use obsidian-cli to search by name or content and create new notes in any folder.
Moves and renames update [[wikilinks]] and Markdown links across the vault automatically.
Edit .md files directly; Obsidian picks up changes automatically.
Key Features
Vault Discovery
Automatically reads Obsidian's config to find active vaults, supporting multi-vault setups.
Note Search
Search by note name or full-text content with snippets and line numbers.
Safe Rename & Move
Automatically refactors [[wikilinks]] and Markdown links when moving or renaming notes.
Note Creation
Create new notes in any folder with initial content and optional auto-open in Obsidian.
Direct File Editing
Edit Markdown files directly since Obsidian syncs changes instantly.
Default Vault Management
Set and query a default vault so you don't need to pass paths repeatedly.
Requirements
- No VM required.
- obsidian-cli is required and can be installed via Homebrew.
- The Obsidian desktop app is required for URI handler support (auto-open).
Use Cases
Knowledge Management
Organize, search, and update your personal knowledge base.
Note Automation
Create daily notes, meeting summaries, or project logs automatically.
Vault Refactoring
Reorganize vault structure with automatic link updates across notes.
Content Search
Quickly find information across hundreds of notes using full-text search.
How to Install
npx clawhub@latest install obsidianRun in your terminal, or click the Install button at the top of this page for one-click setup.
FAQ
Do I need Obsidian installed?
Obsidian is required for URI-handler features like auto-open; other operations work on vault files directly.
Where does it find my vaults?
It reads Obsidian's config file at `~/Library/Application Support/obsidian/obsidian.json` to discover vaults.
Will renaming update links?
Yes. obsidian-cli updates [[wikilinks]] and Markdown links across the vault when you move or rename notes.
How do I set a default vault?
Use `obsidian-cli set-default` and check it with `obsidian-cli print-default`.
Can I search by content?
Yes. Use `obsidian-cli search-content` to find matches with snippets and line numbers.
What if I have multiple vaults?
Multi-vault setups are supported; specify a vault or set a default.