obsidian-cli

Control an Obsidian vault via CLI for notes, tasks, and metadata.

Updated May 26, 2026
One-click install
npx skills add https://github.com/XWIlluDelu/agent-share --skill obsidian-cli-xwilludelu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/XWIlluDelu/agent-share/tree/main/lib/obsidian-cli
Command: npx skills add https://github.com/XWIlluDelu/agent-share --skill obsidian-cli-xwilludelu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the friction of managing Obsidian notes manually by letting you read, create, search, and update vault content through a CLI while Obsidian is running.

Core Features & Use Cases

  • Read and manipulate notes: Create notes from templates, append content, and update metadata/properties from the command line.
  • Search and inspect vault data: Run search queries with limits, and retrieve structured information like tasks, tags, backlinks, and properties.
  • Support plugin/theme development workflows: Reload plugins, check development errors, run JavaScript in the app context, capture screenshots, and inspect the DOM for debugging.

Quick Start

Create a new note named "My Note" with the content "Hello world" in your active Obsidian vault by running: obsidian create name="My Note" content="Hello world"

Frequently Asked Questions about obsidian-cli

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

FAQPage Schema
How do I manage Obsidian notes from the command line?

You can manage Obsidian notes from the command line by using a dedicated CLI to read, create, search, and update vault content, including appending text and modifying metadata, while your Obsidian instance is running.

Can I automate Obsidian vault tasks without opening the app interface?

Yes, you can automate Obsidian vault tasks by executing CLI commands to create notes from templates, run search queries with limits, and retrieve structured information like tasks, tags, backlinks, and properties.

Does Obsidian CLI work for plugin and theme development workflows?

Yes, Obsidian CLI supports plugin and theme development workflows by enabling you to reload plugins, check development errors, run JavaScript in the app context, capture screenshots, and inspect the DOM for debugging.

Do I need a running Obsidian instance to use command line vault automation?

Yes, command line vault automation requires a running Obsidian instance because the CLI interacts directly with the active application context to execute deterministic file and metadata operations.

What's the best way to search and inspect vault data in Obsidian externally?

The best way to search and inspect vault data externally is using a CLI that targets the active vault, allowing you to execute search queries, retrieve structured metadata like tags and backlinks, and inspect DOM elements.

How do I create an Obsidian note with specific content from the terminal?

To create an Obsidian note from the terminal, run a CLI command specifying the note name and content parameters, which generates the note directly in your active vault without manual interface interaction.