name: obsidian description: Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli. homepage: https://help.obsidian.md metadata: {"clawdbot":{"emoji":"💎","requires":{"bins":["obsidian-cli"]},"install":[{"id":"brew","kind":"brew","formula":"yakitrak/yakitrak/obsidian-cli","bins":["obsidian-cli"],"label":"Install obsidian-cli (brew)"}]}}

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.)

Obsidian desktop tracks vaults here (source of truth):

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

Fast “what vault is active / where are the notes?”

If you’ve already set a default: obsidian-cli print-default --path-only
Otherwise, read ~/Library/Application Support/obsidian/obsidian.json and use the vault entry with "open": true.

Notes

Multiple vaults common (iCloud vs ~/Documents, work/personal, etc.). Don’t guess; read config.
Avoid writing hardcoded vault paths into scripts; prefer reading the config or using print-default.

Pick a default vault (once):

Create

obsidian-cli create "Folder/New note" --content "..." --open
Requires Obsidian URI handler (obsidian://…) working (Obsidian installed).
Avoid creating notes under “hidden” dot-folders (e.g. .something/...) via URI; Obsidian may refuse.

Move/rename (safe refactor)

obsidian-cli move "old/path/note" "new/path/note"
Updates [[wikilinks]] and common Markdown links across the vault (this is the main win vs mv).

Delete

Prefer direct edits when appropriate: open the .md file and change it; Obsidian will pick it up.