obsidian-cli

Executes guarded Obsidian CLI commands for vault search, properties, links, and note management.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/ehartye/wiki-master --skill obsidian-cli-ehartye
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/ehartye/wiki-master/tree/main/skills/obsidian-cli
Command: npx skills add https://github.com/ehartye/wiki-master --skill obsidian-cli-ehartye

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Driving the native Obsidian CLI from an agent is error-prone: Windows resolves the wrong binary, empty results are ambiguous, and unguarded writes can corrupt notes. This Skill defines a guarded calling contract so wiki operations against a live Obsidian vault stay safe and auditable. ## Core Features & Use Cases - Guarded command execution: Routes all CLI calls through a wrapper script with locking, timeouts, and rejection of oversized or multiline requests. - Search, links, and properties: Covers read/search with cost probing, backlinks and unresolved-link inspection, and typed frontmatter property get/set. - Empty-result verification: Distinguishes a real empty result from a dead backend using a lazy canary probe before acting on emptiness. - Use Case: While maintaining a wiki vault, an agent needs to check whether a note has backlinks before archiving it; this Skill provides the exact guarded command sequence and the verification step to trust the answer. ## Quick Start Ask the agent to use the obsidian-cli skill to search the vault for notes tagged neural and list their backlinks.

Frequently Asked Questions about obsidian-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Obsidian CLI commands from an agent or script?▼

Invoke commands through the guarded wrapper script rather than calling the obsidian binary directly. The wrapper enforces a shared lock, a 10-second timeout, and rejects oversized or multiline requests before launch.

How do I search an Obsidian vault from the command line?▼

Use the search command with query, path, limit, and format parameters, scoping to the wiki path by default. Probe cost first with the total parameter, and avoid search:context unless both a path and a narrow query are set.

Why does the obsidian command print nothing on Windows Git Bash?▼

Git Bash does not apply PATHEXT, so a bare obsidian call resolves to the GUI binary instead of the Obsidian.com terminal redirector, producing empty output. Use PowerShell or the vault helper module instead.

How can I tell if an empty search result means the Obsidian app is down?▼

Run a canary query for a common term with the total parameter; a live backend prints a number, proving the earlier empty was real. A dead app exits with an error rather than a silent empty, so only probe when an empty result would drive a decision.

Should I create or edit notes through the Obsidian CLI?▼

No. Ordinary Markdown bodies should be written through exact-path filesystem edits under the known vault root, preserving existing content. Reserve the CLI for app-only functions like typed properties, bases queries, and moves.