obsidian-cli

Manage Obsidian vault notes, tasks, and plugins via the obsidian command-line interface.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you read, create, search, and manage notes in an Obsidian vault from the command line, and gives plugin developers a scripted reload-test-debug loop without manual clicking in the app. ## Core Features & Use Cases - Vault Operations: Read, create, append to, and search notes, manage daily notes, tasks, tags, properties, and backlinks using commands like obsidian create and obsidian search. - Plugin & Theme Development: Reload plugins, capture errors, run JavaScript in the app context, take screenshots, and inspect the DOM to debug changes. - Use Case: After editing a plugin's source code, run obsidian plugin:reload id=my-plugin, check obsidian dev:errors, and verify the UI with obsidian dev:screenshot to confirm the fix. ## Quick Start Ask the assistant to use the obsidian CLI to search your vault for notes containing a specific term and show 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 the obsidian create command with a name and content parameter, for example obsidian create name="My Note" content="Hello world". Add the silent flag to prevent the new file from opening in the app.

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

Run obsidian search query="your term" with an optional limit parameter to cap results. 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 CLI interacts with a running Obsidian instance, so the app must be open. 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 elements using obsidian dev:dom.

Can I run JavaScript inside Obsidian from the CLI?▼

Yes, use obsidian eval code="..." to execute JavaScript in the app context, such as obsidian eval code="app.vault.getFiles().length". This is useful for debugging plugins and inspecting app state.