obsidian-cli

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault from the command line or an agent environment normally requires manual clicking in the app. This Skill lets you read, create, search, and update notes, tasks, and properties programmatically, and also supports plugin and theme development workflows like reloading, error capture, and DOM inspection. ## Core Features & Use Cases - Vault Operations: Read, create, append to, and search notes, manage daily notes, tasks, tags, properties, and backlinks using the obsidian CLI. - Plugin & Theme Development: Reload plugins, capture errors, take screenshots, inspect the DOM and CSS, and run JavaScript in the app context for debugging. - Use Case: Ask the agent to append a new task to today's daily note, then search the vault for all notes tagged with a project name and list their backlinks. ## Quick Start Use the obsidian CLI to create a note named "Meeting Notes" with a heading and then search my vault for notes mentioning "roadmap".

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?▼

Run obsidian create with name and content parameters, for example obsidian create name="My Note" content="# Hello". Add the silent flag to prevent the file from opening and use template to apply a template.

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

Use obsidian search with a query parameter, such as obsidian search query="search term" 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 a running Obsidian instance to interact with. 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 issues. Verify visually with obsidian dev:screenshot or inspect the DOM with obsidian dev:dom.

What is the difference between file and path parameters in Obsidian CLI?▼

The file parameter resolves like a wikilink using just the note name, while path requires the exact path from the vault root such as folder/note.md. Without either, the currently active file is used.