obsidian-vault

name	obsidian-vault
description	Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

Obsidian Vault

Vault location

Resolve the vault path in this order:

1. OBSIDIAN_VAULT environment variable, if set.
2. A repo-local or home config value documented by the user.
3. Common locations such as ~/Obsidian, ~/Obsidian Vault, ~/Documents/Obsidian, or mounted drives.

If no vault path is clear, ask the user for it before reading or writing notes.

Naming conventions

• Index notes: aggregate related topics (e.g., Ralph Wiggum Index.md, Skills Index.md, RAG Index.md)
• Title case for all note names
• No folders for organization - use links and index notes instead

Linking

• Use Obsidian [[wikilinks]] syntax: [[Note Title]]
• Notes link to dependencies/related notes at the bottom
• Index notes are just lists of [[wikilinks]]

Workflows

Search for notes

# Search by filename
find "$OBSIDIAN_VAULT" -name "*.md" | grep -i "keyword"

# Search by content
grep -rl "keyword" "$OBSIDIAN_VAULT" --include="*.md"

Or use Grep/Glob tools directly on the vault path.

Create a new note

1. Use Title Case for filename
2. Write content as a unit of learning (per vault rules)
3. Add [[wikilinks]] to related notes at the bottom
4. If part of a numbered sequence, use the hierarchical numbering scheme

Find related notes

Search for [[Note Title]] across the vault to find backlinks:

grep -rl "\\[\\[Note Title\\]\\]" "$OBSIDIAN_VAULT"

Find index notes

find "$OBSIDIAN_VAULT" -name "*Index*"