obsidian-cli

Controls a running Obsidian instance via the obsidian CLI for vault operations and plugin development.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill obsidian-cli-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/allemaar/open-skills/tree/main/skills/obsidian-cli
Command: npx skills add https://github.com/allemaar/open-skills --skill obsidian-cli-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault from the command line or an AI agent normally requires manual clicking in the app; this Skill lets you search notes, edit content, toggle tasks, and debug plugins against a live Obsidian session programmatically. ## Core Features & Use Cases - Vault Operations: Search the vault, read/create/append notes, manage daily notes, set properties, list tags and backlinks using file or path targeting. - Plugin Development Workflow: Reload plugins, check dev errors, capture screenshots, inspect the DOM and console, and run JavaScript in the app context for a full develop-test cycle. - Use Case: While developing an Obsidian plugin, run obsidian plugin:reload id=my-plugin, then obsidian dev:errors and obsidian dev:screenshot to verify changes without leaving your terminal. ## Quick Start Ask the agent to search your Obsidian vault for notes tagged with a specific topic and open the top result in the running app.

Frequently Asked Questions about obsidian-cli

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

FAQPage Schema
How do I search my Obsidian vault from the command line?

Run `obsidian search query="your term" limit=10` with the obsidian CLI while Obsidian is open. Add `vault="Vault Name"` as the first parameter to target a specific vault instead of the most recently focused one.

How do I reload an Obsidian plugin after code changes?

Run `obsidian plugin:reload id=your-plugin-id` to reload the plugin, then check `obsidian dev:errors` for issues. Verify visually with `obsidian dev:screenshot` or inspect the DOM with `obsidian dev:dom`.

What is the difference between obsidian-cli and editing markdown files directly?

The obsidian CLI operates on a live running Obsidian session, so it can open notes, reload plugins, and run app-context JavaScript. Direct .md file edits on disk work without Obsidian running but cannot trigger app behavior or plugin state changes.

Does the obsidian CLI work when Obsidian is closed?

No, the obsidian CLI requires a running Obsidian instance to execute commands. Commands target the most recently focused vault by default, or a named vault via the vault parameter.

How do I target a specific note with obsidian CLI commands?

Use `file="Note Name"` to resolve a note like a wikilink without path or extension, or `path="folder/note.md"` for an exact path from the vault root. Without either, commands act on the currently active file.