obsidian-cli

Manage Obsidian vaults and debug plugins through the Obsidian CLI.

Updated May 10, 2026
One-click install
npx skills add https://github.com/cookkie03/skills --skill obsidian-cli-cookkie03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/cookkie03/skills/tree/main/obsidian-cli
Command: npx skills add https://github.com/cookkie03/skills --skill obsidian-cli-cookkie03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with an Obsidian vault from the terminal or an AI assistant normally requires manual file manipulation and guesswork about note locations, and plugin developers lack a fast feedback loop for testing changes. This Skill provides structured command-line access to a running Obsidian instance for note management and plugin development. ## Core Features & Use Cases - Vault Operations: Read, create, append, search, and manage notes, tasks, properties, tags, and backlinks using commands like obsidian read, obsidian create, and obsidian search. - Plugin & Theme Development: Reload plugins, capture errors, run JavaScript in the app context, take screenshots, and inspect the DOM with commands like obsidian plugin:reload and obsidian dev:errors. - Use Case: After editing a plugin's source code, run obsidian plugin:reload id=my-plugin, check obsidian dev:errors for failures, and verify the UI with obsidian dev:screenshot — all without touching the Obsidian window. ## Quick Start Ask the assistant to use the obsidian CLI to search your vault for notes containing a specific term and list the results.

Frequently Asked Questions about obsidian-cli

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

FAQPage Schema
How do I create a note in Obsidian from the command line?

Use `obsidian create name="My Note" content="Hello world"` to create a note in the active vault. Add the `silent` flag to prevent the file from opening, and use `vault="Vault Name"` as the first parameter to target a specific vault.

How do I search my Obsidian vault from the terminal?

Run `obsidian search query="search term" limit=10` to search vault content. Commands target the most recently focused vault by default, and you can add `--copy` to copy results to the clipboard.

Does the Obsidian CLI work when Obsidian is closed?

No, the Obsidian CLI requires Obsidian to be open because it interacts with a running Obsidian instance. Commands cannot operate on a vault while the application is closed.

How do I reload an Obsidian plugin after code changes?

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

How do I target a specific file with Obsidian CLI commands?

Use `file=<name>` to resolve a note like a wikilink by name only, or `path=<path>` for an exact path from the vault root such as `folder/note.md`. Without either parameter, the active file is used.