obsidian

Installation
Summary

Automate Obsidian vault operations and search plain Markdown notes via obsidian-cli.

  • Requires obsidian-cli binary; install via Homebrew or manually
  • Core commands: search note names or content with snippets, create notes with optional auto-open, move/rename notes with automatic wikilink and Markdown link updates across the vault, and delete notes
  • Vaults are standard folders on disk containing .md files, .canvas JSON files, and a .obsidian/ config directory; read the active vault from ~/Library/Application Support/obsidian/obsidian.json rather than hardcoding paths
  • Set a default vault once with set-default, then use print-default to retrieve it; supports multiple vaults (iCloud, local, work/personal)
SKILL.md

Obsidian

Obsidian vault = a normal folder on disk.

Vault structure (typical)

  • Notes: *.md (plain text Markdown; edit with any editor)
  • Config: .obsidian/ (workspace + plugin settings; usually don’t touch from scripts)
  • Canvases: *.canvas (JSON)
  • Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.)

Find the active vault(s)

Obsidian desktop tracks vaults here (source of truth):

  • ~/Library/Application Support/obsidian/obsidian.json

obsidian-cli resolves vaults from that file; vault name is typically the folder name (path suffix).

Related skills
Installs
1.8K
GitHub Stars
371.9K
First Seen
Jan 24, 2026