Obsidian Vault
SkillSearchLets your agent act as an obsidian skill that finds, reads, and writes notes in your vault.
Available today. Use it from your connected AI after setup.
No other account needed.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the Obsidian Vault skill
About this skill
Read, search, and create notes in the Obsidian vault.
What this skill tells your AI
The instructions your AI receives, as published by tommy-yw/runbookhermes in skills/note-taking/obsidian/SKILL.md and read by ahel’s review.
Location: Set via OBSIDIAN_VAULT_PATH environment variable (e.g. in ~/.hermes/.env).
If unset, defaults to ~/Documents/Obsidian Vault.
Note: Vault paths may contain spaces - always quote them.
Read a note
VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
cat "$VAULT/Note Name.md"
List notes
VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
# All notes
find "$VAULT" -name "*.md" -type f
# In a specific folder
ls "$VAULT/Subfolder/"
Search
VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
# By filename
find "$VAULT" -name "*.md" -iname "*keyword*"
# By content
grep -rli "keyword" "$VAULT" --include="*.md"
Create a note
VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
cat > "$VAULT/New Note.md" << 'ENDNOTE'
# Title
Content here.
ENDNOTE
Append to a note
VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
echo "
New content here." >> "$VAULT/Existing Note.md"
Wikilinks
Obsidian links notes with [[Note Name]] syntax. When creating notes, use these to link related content.
Signals
- GitHub stars
- 547
- Forks
- 41
- Last commit
- May 2026
- Hacker News mentions
- 20
Advanced
- Item type
- skill
- Key
obsidian-tommy-yw- Source
- github.com/tommy-yw/runbookhermes