obsidian-cli

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

2|Updated May 8, 2026
One-click install
npx skills add https://github.com/xotong/claude-marketplace --skill obsidian-cli-xotong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/xotong/claude-marketplace/tree/main/plugins/obsidian/skills/obsidian-cli
Command: npx skills add https://github.com/xotong/claude-marketplace --skill obsidian-cli-xotong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interacting with Obsidian vaults can require switching into the app; this skill enables command-line access to read, create, search, and manage notes, tasks, and properties, accelerating workflows and reducing context switches. It also provides developer-oriented commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM for plugin and theme development.

Core Features & Use Cases

  • Read, create, and update notes and tasks in a running Obsidian vault from the CLI.
  • Search vault content, target specific vaults, and manage note properties via commands.
  • Developer utilities: reload plugins, execute JavaScript, capture errors, take screenshots, and inspect the DOM for plugin/theme development.

Quick Start

Install the obsidian-cli skill and start by reading a note from your active vault using a simple command.

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 from the command line?

Obsidian vault notes can be managed from the command line using a CLI skill that reads, creates, updates, and searches notes in a running vault. This requires the Obsidian app to be running with a vault open.

Can I search and update tasks in my Obsidian vault without opening the app?

Yes, you can search and update tasks in your Obsidian vault without switching to the app by executing CLI commands. The CLI interacts directly with the active vault to manage tasks and note properties.

What is the best way to develop Obsidian plugins and themes from the CLI?

The best way to develop Obsidian plugins and themes from the CLI is using specialized developer commands. These commands reload plugins, execute JavaScript, capture errors, inspect the DOM, and take screenshots.

Does the Obsidian CLI work when the app is closed?

No, the Obsidian CLI does not work when the app is closed. It requires Obsidian to be running and a vault to be open so the CLI can interact with notes, tasks, and plugins.

How do I capture errors and inspect the DOM when building Obsidian plugins?

You can capture errors and inspect the DOM when building Obsidian plugins by running developer utility commands through the CLI. These commands interact with the active vault to execute JavaScript and take screenshots.