obsidian-cli

Controls Obsidian vaults via CLI to read, create, search notes and debug plugins.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Obsidian notes, tasks, and properties from the command line or debugging Obsidian plugins normally requires manual interaction with the app UI, which breaks automation workflows and slows down plugin development cycles. ## Core Features & Use Cases - Vault Operations: Read, create, append, search, and manage notes, daily notes, tasks, tags, backlinks, and properties using the obsidian CLI against a running Obsidian instance. - Plugin & Theme Development: Reload plugins, capture errors, run JavaScript in the app context, take screenshots, inspect the DOM, and check console output for a tight develop-test loop. - Use Case: While developing an Obsidian plugin, run obsidian plugin:reload id=my-plugin, check obsidian dev:errors, and verify the UI with obsidian dev:screenshot — all without touching the app window. ## Quick Start Ask the assistant to search your Obsidian vault for notes matching a keyword and append a new task to today's daily note using the obsidian CLI.

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 with name and content parameters, for example obsidian create name="My Note" content="Hello world". Add the silent flag to prevent the file from opening and overwrite to replace an existing note.

How do I search my Obsidian vault from the terminal?▼

Run obsidian search query="search term" with an optional limit parameter, such as obsidian search query="test" limit=10. You can target a specific vault by passing vault="Vault Name" as the first parameter.

Does the obsidian CLI work when Obsidian is closed?▼

No, the obsidian CLI requires Obsidian to be open because it communicates with a running instance. Commands target the most recently focused vault unless you specify one with the vault parameter.

How do I reload an Obsidian plugin after code changes?▼

Run obsidian plugin:reload id=your-plugin-id to pick up changes, then check obsidian dev:errors for problems. Verify the result visually with obsidian dev:screenshot or inspect the DOM with 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, the command acts on the currently active file.