obsidian-cli

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

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill obsidian-cli-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/experimental/obsidian-cli
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill obsidian-cli-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with an Obsidian vault from scripts or an AI agent normally requires manual clicking in the app. This Skill lets you read, create, search, and update notes, tasks, and properties directly from the command line against a running Obsidian instance, and also supports plugin and theme development workflows. ## Core Features & Use Cases - Vault Operations: Read, create, append to, and search notes, manage daily notes, set properties, list tags, and inspect backlinks using commands like obsidian read, obsidian create, and obsidian search. - Plugin & Theme Development: Reload plugins, capture errors, take screenshots, inspect the DOM, evaluate JavaScript, and read console output with obsidian plugin:reload, obsidian dev:errors, and obsidian dev:screenshot. - Use Case: While developing an Obsidian plugin, edit the code, run obsidian plugin:reload id=my-plugin, check obsidian dev:errors, and verify the UI with obsidian dev:screenshot — all without touching the app window. ## Quick Start Ask the assistant to create a new note named "Meeting Notes" in your Obsidian vault with a heading and a to-do item 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 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 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. Commands target the most recently focused vault by default, or specify vault="Vault Name" as the first parameter.

Does the obsidian CLI work when the Obsidian app is closed?

No, the Obsidian app must be open because the CLI sends commands to the running instance. The obsidian binary must also be installed and available on your PATH.

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 problems. Verify the result visually with obsidian dev:screenshot or inspect elements using obsidian dev:dom.

How do I target a specific note or vault with obsidian CLI commands?

Use file="Note Name" to resolve a note like a wikilink, or path="folder/note.md" for an exact vault-relative path. To choose a vault, pass vault="Vault Name" as the first parameter; otherwise the most recently focused vault is used.