obsidian-cli

Control Obsidian vaults from the command line to read, write, and query notes and metadata.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/psauxwwf/.dotfiles --skill obsidian-cli-psauxwwf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/psauxwwf/.dotfiles/tree/main/.agents/skills/obsidian-cli
Command: npx skills add https://github.com/psauxwwf/.dotfiles --skill obsidian-cli-psauxwwf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vault management is streamlined by enabling direct command-line interactions to read, create, search, and organize notes, tasks, and metadata without switching to the GUI.

Core Features & Use Cases

  • Read and create notes from the terminal, search vault content quickly, and manage note properties and tasks.
  • Develop and debug Obsidian plugins and themes with in-app commands and DOM inspection utilities when Obsidian is running.
  • Use cases include rapid note creation during research, batch updates across vaults, and scripting routine vault maintenance from scripts.

Quick Start

Open Obsidian and use the obsidian CLI to read, create, and search notes in your 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 vaults from the command line?

You can manage Obsidian vaults from the command line by using the obsidian CLI to read, create, and search notes. This requires a running Obsidian instance to execute vault operations and query metadata directly from your terminal.

Can I develop and debug Obsidian plugins from the terminal?

Yes, you can develop and debug Obsidian plugins from the terminal using in-app commands and DOM inspection utilities. This allows you to inspect running Obsidian instances for plugin and theme development without relying solely on the GUI.

How do I batch update notes and metadata across an Obsidian vault?

You can batch update notes and metadata across an Obsidian vault by scripting routine maintenance tasks with the obsidian CLI. It enables automated reading, writing, and searching of note properties while Obsidian runs in the background.

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

No, the obsidian CLI requires Obsidian to be open and running to execute commands. It interacts directly with running Obsidian instances to perform note management, search, and plugin debugging operations.

What is the best way to search vault content in Obsidian without using the GUI?

The best way to search vault content without the GUI is using the obsidian CLI to query notes and metadata. It provides command-line search capabilities to quickly find information within your vault during research or automated workflows.