obsidian-cli

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

Updated May 27, 2026
One-click install
npx skills add https://github.com/baljinnyamday/autonomous-red-team-agent --skill obsidian-cli-baljinnyamday
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/baljinnyamday/autonomous-red-team-agent/tree/main/agent-baseline/.agents/skills/obsidian-cli
Command: npx skills add https://github.com/baljinnyamday/autonomous-red-team-agent --skill obsidian-cli-baljinnyamday

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault from the command line or an AI agent normally requires manual file manipulation or the Obsidian GUI. This Skill exposes the Obsidian CLI so you can read, create, search, and update notes, tasks, and properties programmatically, and debug plugins without leaving your workflow. ## Core Features & Use Cases - Vault Operations: Read, create, append to, and search notes, manage daily notes, tasks, tags, backlinks, and frontmatter properties using simple commands like obsidian create name="My Note". - Plugin & Theme Development: Reload plugins, capture errors, run JavaScript in the app context, take screenshots, and inspect the DOM to test changes iteratively. - 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 after every code change. ## Quick Start Ask the assistant to use the obsidian CLI to create a new note named "Meeting Notes" with a heading and then search the vault for related notes.

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, for example obsidian create name="My Note" content="# Hello". Add the silent flag to prevent the file from opening and the overwrite flag 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 limit=10. You can target a specific vault by passing vault="Vault Name" as the first parameter.

Does the Obsidian CLI require Obsidian to be running?

Yes, the obsidian CLI interacts with a running Obsidian instance, so the application 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=my-plugin to reload the plugin, then check obsidian dev:errors for issues. Verify the result visually with obsidian dev:screenshot or inspect the DOM with obsidian dev:dom.

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

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