Obsidian Skill

Obsidian CLI

Controls the running Obsidian app via IPC. First invocation launches Obsidian if not running.

Prerequisites

1. Install Obsidian 1.12+
2. Enable CLI: Settings → General → Command line interface → follow registration prompt
3. Restart terminal (registration adds obsidian to PATH automatically)

Platform-specific PATH details:

• macOS: appends /Applications/Obsidian.app/Contents/MacOS to ~/.zprofile
• Linux: symlink at /usr/local/bin/obsidian (fallback ~/.local/bin/obsidian)
• Windows: requires Obsidian.com redirector from Discord #insider-desktop-release

Syntax

obsidian  [vault=] [file=] [path=] [flags] [--copy]

| Pattern | Behavior | |---------|----------| | vault= | Target vault by name; defaults to cwd vault or active vault | | file= | Wikilink-style resolution (no path/extension needed) | | path= | Exact vault-relative path, e.g. path="Folder/Note.md" | | total | Return count instead of list | | format=json\|text\|csv\|tsv\|md | Output format (varies per command) | | --copy | Copy any command's output to clipboard | | \n / \t | Newline / tab in content strings | | No file/path | Defaults to active file in Obsidian | | Bare obsidian | Opens interactive TUI with autocomplete + Ctrl+R history |

Quick start

These five operations cover most agent tasks. For complete command reference, see the domain-specific guides below.

Read a note

obsidian read file="Meeting Notes"
obsidian read path="Projects/Roadmap.md"
obsidian read                              # active file

Create a note

obsidian create name="New Note" content="# Title\n\nBody"
obsidian create name="From Template" template="Meeting Notes" silent

Append / prepend

obsidian append file="Journal" content="- New entry"
obsidian prepend file="Ideas" content="## Latest idea"
obsidian daily:append content="- 2pm: Call with team" silent

Search

obsidian search query="project deadline"
obsidian search query="API" limit=10 format=json
obsidian search query="fix" matches         # include context

Tasks

obsidian tasks all todo                     # vault-wide incomplete
obsidian tasks daily                        # today's daily note
obsidian task file="Todo" line=8 toggle     # toggle completion

Reference guides

Load these on demand based on the task:

| Task | Reference | |------|-----------| | Read, create, edit, move, delete notes; outline; word count; unique notes | [references/note-operations.md](references/note-operations.md) | | Search, tags, properties, backlinks, orphans, unresolved links, aliases | [references/search-metadata.md](references/search-metadata.md) | | Daily notes, tasks, templates | [references/daily-tasks-templates.md](references/daily-tasks-templates.md) | | Vault info, files/folders, bookmarks, plugins, workspaces, themes, sync, publish, bases, dev tools | [references/vault-management.md](references/vault-management.md) |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wizzy15
• Source: wizzy15/obsidian-skill
• License: MIT

Install and usage instructions live in the source repository linked above.