| name | obsidian |
| description | Read, write, and search local Obsidian vault markdown files via the filesystem. |
| always | false |
| metadata | {"clawlite":{"emoji":"💎","requires":{"bins":["find","grep"]}}} |
Obsidian
Use this skill when the user wants to interact with their local Obsidian vault (markdown files).
Vault location
Check OBSIDIAN_VAULT env var or ask the user. Default paths:
- macOS:
~/Documents/Obsidian or ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/
- Linux:
~/obsidian or ~/Documents/obsidian
Operations
Search notes
grep -r "query" "$OBSIDIAN_VAULT" --include="*.md" -l
grep -r "query" "$OBSIDIAN_VAULT" --include="*.md" -n
Read a note
cat "$OBSIDIAN_VAULT/path/to/note.md"
List all notes
find "$OBSIDIAN_VAULT" -name "*.md" | sort
Create or append a note
cat > "$OBSIDIAN_VAULT/folder/new-note.md" <<EOF
---
created: $(date -I)
tags: [tag1, tag2]
---
# Title
Content here.
EOF
echo "\n## New Section\n\ncontent" >> "$OBSIDIAN_VAULT/existing-note.md"
Search by frontmatter tag
grep -r "tags:.*mytag" "$OBSIDIAN_VAULT" --include="*.md" -l
Safety notes
- Always resolve
$OBSIDIAN_VAULT before operating.
- Do not delete notes without explicit user confirmation.
- Preserve existing frontmatter when updating files.