Obsidian Vault

SkillSearch

Lets your agent act as an obsidian skill that finds, reads, and writes notes in your vault.

Use Obsidian Vault in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Obsidian Vault and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Obsidian Vault skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Obsidian VaultStart free
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
546
Forks
41
Last commit
May 2026
Hacker News mentions
20
Advanced
Item type
skill
Key
obsidian-tommy-yw
Source
github.com/tommy-yw/runbookhermes