obsidian-cli

Manage Obsidian vaults and debug plugins through the Obsidian CLI.

2|Updated May 30, 2026
One-click install
npx skills add https://github.com/virahitvin8/crafty-gis --skill obsidian-cli-virahitvin8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/virahitvin8/crafty-gis/tree/main/GIT_STAR/assignment-generator/antigravity-skills-main/antigravity-skills-main/skills/obsidian-cli
Command: npx skills add https://github.com/virahitvin8/crafty-gis --skill obsidian-cli-virahitvin8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the need to manually click through the Obsidian app to read, create, search, and organize notes, and gives plugin developers a repeatable command-line workflow for reloading, debugging, and inspecting their code. ## Core Features & Use Cases - Vault Operations: Read, create, append to, and search notes, manage daily notes, tasks, tags, properties, and backlinks from the command line. - Plugin and Theme Development: Reload plugins, capture errors, run JavaScript in the app context, take screenshots, inspect the DOM, and read console output. - Use Case: While developing an Obsidian plugin, run obsidian plugin:reload id=my-plugin, check obsidian dev:errors, and capture a screenshot to verify UI changes without touching the app window. ## Quick Start Ask the assistant to use the obsidian CLI to search your vault for a note and append a new task to today's daily note.

Frequently Asked Questions about obsidian-cli

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

FAQPage Schema
How do I create and edit Obsidian notes from the command line?

Use the obsidian CLI with commands like obsidian create name="My Note" content="Hello" and obsidian append file="My Note" content="New line". Target files with file= for wikilink-style resolution or path= for exact vault paths.

How do I search my Obsidian vault from the terminal?

Run obsidian search query="search term" limit=10 to find matching notes. Add vault="Vault Name" as the first parameter to target a specific vault instead of the most recently focused one.

Does the Obsidian CLI work without the Obsidian app open?

No, the obsidian CLI requires a running Obsidian instance to execute commands. It communicates with the open app, so vault operations and developer commands fail if Obsidian is closed.

How do I reload and debug an Obsidian plugin during development?

Run obsidian plugin:reload id=my-plugin after code changes, then check obsidian dev:errors for failures. Verify behavior with obsidian dev:screenshot, obsidian dev:dom, and obsidian dev:console level=error.

Can I run JavaScript inside Obsidian from the CLI?

Yes, use obsidian eval code="app.vault.getFiles().length" to execute JavaScript in the app context. This is useful for inspecting vault state and testing plugin logic without writing a full command.