obsidian-cli

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

6|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/caitengwei/my-skills --skill obsidian-cli-caitengwei
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/caitengwei/my-skills/tree/main/obsidian-skills/skills/obsidian-cli
Command: npx skills add https://github.com/caitengwei/my-skills --skill obsidian-cli-caitengwei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the need to manually click through Obsidian to read, create, search, and update vault content, while also supporting plugin and theme development workflows.

Core Features & Use Cases

  • Vault and note operations: Create, read, append, and manage notes and tasks from the CLI.
  • Search and content introspection: Search by query, read backlinks, inspect tags, properties, daily notes, and tasks.
  • Developer tooling for Obsidian: Reload plugins, run JavaScript in the app context, capture errors, take screenshots, and inspect the DOM for faster debugging.

Quick Start

Use the obsidian-cli skill to search your vault for matching pages by giving the instruction: obsidian vault="My Vault" search query="project status" limit=10.

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

You can manage Obsidian vault content from the command line by using the obsidian-cli to create, read, search, and update notes or tasks. It requires a running Obsidian instance and uses official CLI syntax for deterministic vault targeting.

Can I automate daily note tasks and search queries in Obsidian without opening the app?

Yes, you can automate daily note tasks and search queries in Obsidian without opening the app. The CLI supports searching by query, reading backlinks, inspecting tags, and managing tasks and properties directly from the terminal.

Does Obsidian CLI support plugin development and debugging workflows?

Obsidian CLI supports plugin development and debugging workflows by allowing you to reload plugins, run JavaScript in the app context, capture errors, take screenshots, and inspect the DOM for faster debugging.

What do I need to run Obsidian vault automation commands via the CLI?

To run Obsidian vault automation commands via the CLI, you need a running Obsidian instance. The CLI uses the official obsidian command syntax to target specific vaults and resolve file paths deterministically.

Why use command line tools for Obsidian note management instead of the graphical interface?

Using command line tools for Obsidian note management eliminates the need to manually click through the application interface. This approach streamlines day-to-day vault automation and enables developer workflows like running in-app JavaScript and inspecting screenshots.

What are the limitations of using the command line to interact with an Obsidian vault?

The primary limitation of using the command line to interact with an Obsidian vault is that it requires a running Obsidian instance to function. It cannot execute vault automation or plugin debugging commands if the desktop application is not actively running.