Manages Obsidian vaults using the native obsidian CLI — file operations, search, daily notes, properties, tags, tasks, plugins, sync, and publish. Use when creating, reading, searching, or organising notes, managing properties/tags, working with daily notes or templates, managing vault sync/publish, working across multiple vaults, or any obsidian CLI operation. Do NOT use for Obsidian Markdown syntax guidance (wikilinks, callouts, embeds) — that is content formatting, not CLI operations.
file= vs path= — file= uses wikilink resolution (partial names, no extension needed); path= requires the exact vault-root-relative path. Prefer file= for user-facing lookups, path= for scripting precisionvault=<name> as the first parameter to target a specific vaultfile="My Note". Multiline content uses \n for newlines and \t for tabs--overwrite, sync:restore, publish:add/remove, plugin:install/enable/disable) — these operations modify the vault and may trigger sync side-effectscommand -v obsidian >/dev/null 2>&1
If not found: enable in Obsidian → Settings → General → "Command line interface", then restart your terminal.
Verify the CLI can reach the running app:
obsidian vault
If it fails: ensure Obsidian is running (the CLI requires a live app connection via IPC).
obsidian vault # show current vault info
obsidian vault=Work files # list files in a specific vault
obsidian files # list vault files
obsidian read file="Note Name" # read a note
obsidian create name="New Note" content="# Title\nBody text"
obsidian search query="search term" # search vault
obsidian daily:read # read today's daily note
obsidian properties file="Note" # list note properties
obsidian tags # list all tags
obsidian tasks --todo # list incomplete tasks
references/files-and-folders.mdreferences/search-and-links.mdreferences/daily-notes-and-templates.mdreferences/properties-and-tasks.mdreferences/vault-and-plugins.mdfile= used for user-facing lookups, path= for exact pathsvault= specified when operating outside the target vault's directory--plain, json, tsv, csv) used when parsing results programmatically