obsidian-cli

Read, create, and search Obsidian notes from the command line.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interacting with Obsidian vaults from the command line can be tedious and error-prone; this skill provides a bridge to automate read/write operations, plugin management, and DOM inspections without opening the app.

Core Features & Use Cases

  • Read & Create Notes: Read and create notes from scripts or terminals to keep vault content in sync with external workflows.
  • Search & Navigate Vault Content: Perform fast searches across notes and metadata, returning structured results suitable for automation.
  • Plugin & Theme Development: Reload plugins, run JavaScript in the app context, capture errors, and inspect the DOM for debugging and development.

Quick Start

Read, create, and search Obsidian notes from the command line.

Frequently Asked Questions about obsidian-cli

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

FAQPage Schema
How do I automate Obsidian vault tasks from the command line?

Yes, you can manage Obsidian notes from the command line by reading, creating, and searching vault content to keep it in sync with external workflows. This allows automated note management without manually opening the Obsidian application.

Can I reload plugins and inspect the DOM for Obsidian theme development?

Yes, you can reload plugins and inspect the DOM during Obsidian plugin development from the CLI. This allows you to run JavaScript in the app context and capture errors directly for efficient debugging.

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

Yes, an active Obsidian instance is required to use CLI commands on your vault. The CLI acts as a bridge to the running application, enabling commands that target vault content, plugins, and debugging workflows.

What is the best way to search notes and metadata in an Obsidian vault using scripts?

The best way to search notes and metadata in an Obsidian vault using scripts is via command-line interaction. This performs fast searches across notes and metadata, returning structured results suitable for automation pipelines.

Are there limitations to managing Obsidian tasks from a terminal?

A limitation of managing Obsidian tasks from a terminal is the strict requirement for an active Obsidian instance and the Obsidian CLI installed. It is designed specifically for plugin development and automated workflows, not standalone offline vault editing.