Obsidian Cli

jackal092927/obsidian-official-cli-skills

This gives Claude direct access to Obsidian's CLI for vault operations that need the app's index: search, backlinks, tags, tasks, properties, and bases. The skill is opinionated about when to use CLI versus plain file tools, which is helpful since you don't want to shell out to Obsidian for simple text edits. It includes solid gotchas like "create without silent opens the UI" and "create with template ignores your path parameter." The safety section is notable for calling out commands that should never run without explicit permission. If Obsidian isn't running or the CLI isn't installed, it pushes you toward file tools as fallback. Good reference if you're building agents that work with Obsidian vaults beyond basic file manipulation.

skills.sh installs: 328
GitHub stars: 42
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add jackal092927/obsidian-official-cli-skills --skill obsidian-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

Obsidian CLI — Agent Reference

When to Use CLI vs File Tools

Use CLI when you need Obsidian's index or app features: search, backlinks, links, tags, tasks, properties, bases, templates, outline, orphans, unresolved links

Use file tools (Read/Write/Edit/Grep/Glob) for: simple file read/write, bulk text replacement, grep across files — no app dependency

Rule of thumb: if Obsidian's index adds value, use CLI. If it's plain text manipulation, use file tools.

Syntax Basics

obsidian <command> [param=value ...] [flag ...]

Vault targeting: vault="My Vault" as first param, or run from inside vault dir
File targeting: path=exact/path.md (vault-relative) vs file=name (link-style resolution)
Params: key=value — quote values with spaces: name="My Note"
Flags: boolean switches, no = — e.g. silent, overwrite, counts, total
Multiline: \n for newline, \t for tab in content strings
Structured output: format=json (search, base:query), format=tsv (properties, tags)
Clipboard: append --copy to copy output