From obsidian
Manages Obsidian vaults: search, create, edit, move Markdown notes; handle YAML frontmatter, wikilinks, backlinks, daily notes, Zettelkasten setup, and sync via obsidian-cli.
npx claudepluginhub hamsurang/kit --plugin obsidianThis skill uses the workspace's default tool permissions.
- [Tool Selection Guide](#tool-selection-guide)
Manages Obsidian vaults using obsidian-cli: creates daily notes, moves/renames notes preserving [[wiki-links]], searches content, organizes notes with templates.
Executes Obsidian CLI commands to read/write/append notes, search vaults, list/count files, manage tasks, move/rename notes, and find orphans/broken links.
Automates repetitive Obsidian vault tasks via CLI, shell commands, and scripts: batch-creates notes, bulk-updates frontmatter, runs maintenance, opens notes, navigates programmatically, integrates with external tools.
Share bugs, ideas, or general feedback.
Obsidian vault = a normal folder of Markdown files on disk. Use obsidian-cli only when its features add real value (search, link-aware move/rename, frontmatter ops, opening in Obsidian).
| Task | Best tool |
|---|---|
| Read note content | Read tool |
| Edit note content | Edit tool |
| Create new note | Write tool |
| Create note + open in Obsidian | obsidian-cli create --open |
| Search note names | obsidian-cli search "query" |
| Search inside notes | obsidian-cli search-content "query" |
| Broad content search / regex | Grep tool on vault path |
| Find notes by name pattern | Glob tool on vault path |
| Move/rename note (updates wikilinks) | obsidian-cli move |
| View/edit frontmatter | obsidian-cli frontmatter |
| Open daily note | obsidian-cli daily |
| List vault contents | obsidian-cli list |
| Delete note | obsidian-cli delete |
| Sync vault (no desktop) | ob sync |
Never hardcode paths. Resolve the vault path first:
obsidian-cli print-default --path-only # if default vault is set
cat ~/Library/Application\ Support/obsidian/obsidian.json # otherwise
The config JSON has a vaults object; use the entry with "open": true. If multiple vaults exist, ask the user which to use, then: obsidian-cli set-default "<vault-folder-name>"
Read: Use Read tool on the .md file directly. For backlink context: obsidian-cli print "Note" --mentions
Create: Use Write tool for simple creation. To also open in Obsidian: obsidian-cli create "Folder/Note" --content "..." --open. To append: add --append.
Edit: Use Edit tool — precise diffs, preserves formatting. Prefer over obsidian-cli for content changes.
Search by name: obsidian-cli search "query" — fuzzy match across vault.
Search content: obsidian-cli search-content "query" — snippets + line numbers.
Regex search: Use Grep on vault path (faster, supports regex).
Filename pattern: Use Glob on vault path (e.g., **/daily/**/*.md).
Move/rename: Always use obsidian-cli move "Old/note" "New/note" — updates [[wikilinks]] across vault. Plain mv cannot do this.
Frontmatter:
obsidian-cli frontmatter "Note" --print
obsidian-cli frontmatter "Note" --edit --key "status" --value "done"
obsidian-cli frontmatter "Note" --delete --key "draft"
For bulk frontmatter ops across many notes, use Read + Edit directly — more efficient.
Daily note: obsidian-cli daily — creates if needed, opens in Obsidian.
List vault: obsidian-cli list or obsidian-cli list "Projects" for a subfolder.
Delete: obsidian-cli delete "Folder/note-to-delete"
All obsidian-cli commands accept --vault <name>:
obsidian-cli search "query" --vault "Work"
obsidian-cli create "Note" --content "..." --vault "Personal"
Batch note updates: Use Glob to find files, then Read + Edit per file — faster than calling obsidian-cli repeatedly.
Linked notes: Use Write with [[wikilinks]] in content; Obsidian resolves them on open.
Template-based creation: Read the template, substitute placeholders, Write the new note.
If obsidian-cli is not installed:
OS-specific Obsidian config paths:
~/Library/Application Support/obsidian/obsidian.json~/.config/obsidian/obsidian.json%APPDATA%/obsidian/obsidian.jsonFor headless sync (CI/servers), see the Headless section in references/commands.md.
For detailed flag options, see references/commands.md.
| Situation | Load |
|---|---|
| CLI command options, headless usage | references/commands.md |