obsidian-cli

Manage Obsidian vault notes, tasks, and properties from the command line.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interacting with an Obsidian vault from outside the app can be tedious. This Skill provides a CLI-based interface to read, create, search, and manage notes, tasks, and vault properties, and to support plugin/theme development with debugging aids.

Core Features & Use Cases

  • Read, create, update, and search notes from the command line.
  • Manage tasks, properties, and metadata without opening Obsidian.
  • Developer workflow: reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM during plugin/theme development.

Quick Start

Run a single command to list notes in the active vault.

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 vault notes and tasks from the command line?

You can manage Obsidian vault notes and tasks from the command line by using a CLI interface to read, create, search, and update content without opening the Obsidian UI. This requires the Obsidian CLI and an active Obsidian instance.

Can I reload plugins and debug themes for Obsidian without using the UI?

Yes, you can reload plugins and debug themes for Obsidian without using the UI by executing CLI commands. The interface supports running JavaScript, capturing errors, taking screenshots, and inspecting the DOM during development.

Do I need an active Obsidian instance to use CLI commands on my vault?

Yes, an active and open Obsidian instance is required alongside the installed Obsidian CLI to execute commands. This setup allows the CLI to communicate with the vault and perform operations on notes and properties.

What is the best way to search vault properties and metadata outside of Obsidian?

The best way to search vault properties and metadata outside of Obsidian is using a CLI tool designed for vault interaction. It allows you to query and manage metadata directly from the terminal without loading the graphical interface.

How does DOM inspection work when developing Obsidian plugins from the terminal?

DOM inspection when developing Obsidian plugins from the terminal works by executing CLI commands that interact with the active Obsidian instance. You can inspect the DOM, execute JavaScript, and capture errors directly in the terminal.

Why use a CLI to update vault notes instead of the Obsidian application?

Using a CLI to update vault notes instead of the Obsidian application allows you to automate workflows and operate on vault content programmatically. It is particularly useful for plugin development, debugging, and scripting repetitive tasks.