obsidian-cli

Manage Obsidian vaults and debug plugins through the Obsidian CLI.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/NT-boop-star/BRMV-tract --skill obsidian-cli-nt-boop-star
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/NT-boop-star/BRMV-tract/tree/main/antigravity/skills/obsidian-cli
Command: npx skills add https://github.com/NT-boop-star/BRMV-tract --skill obsidian-cli-nt-boop-star

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with an Obsidian vault from the command line or automating note management normally requires manual app interaction, and debugging plugins or themes involves slow reload-and-check cycles. This Skill provides structured CLI commands to read, create, search, and manage notes, plus a full developer workflow for plugin and theme development. ## Core Features & Use Cases - Vault Operations: Read, create, append to, and search notes, manage properties, tasks, tags, backlinks, and daily notes across one or more vaults. - Plugin & Theme Development: Reload plugins, capture errors, run JavaScript in the app context, take screenshots, inspect the DOM, and check console output. - 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 complete a full test cycle without touching the app. ## Quick Start Ask the assistant to search your Obsidian vault for notes matching a topic, or to create a new note with specific content 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 the obsidian CLI create command with a name and content parameter, such as 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="search term" with an optional limit parameter to control result count. You can target a specific vault by passing vault="Vault Name" as the first parameter.

Does the Obsidian CLI work without Obsidian running?

No, the obsidian CLI requires Obsidian to be open because it communicates with a running app 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 reload the plugin and pick up code changes. Then check obsidian dev:errors for errors and use obsidian dev:screenshot or dev:dom to verify the result visually.

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, commands operate on the currently active file.