obsidian-cli

Manage Obsidian vaults and notes via command-line operations.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/dallay/opencode-docker --skill obsidian-cli-dallay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/dallay/opencode-docker/tree/main/config/skills/obsidian/obsidian-cli
Command: npx skills add https://github.com/dallay/opencode-docker --skill obsidian-cli-dallay

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a straightforward command-line interface to interact with Obsidian vaults so users can read, create, search, and manage notes, tasks, and properties without relying solely on the GUI.

Core Features & Use Cases

  • Note and File Management: Read, create, append, and target files by name or path to automate note workflows and batch edits.
  • Search and Metadata: Perform vault-wide searches, list backlinks, and manage properties and tags for task and project tracking.
  • Plugin and Theme Development: Reload plugins, capture runtime errors, run JavaScript in the app context, take screenshots, and inspect the DOM to iterate and debug extensions quickly.
  • Use Case: Automate creating daily notes with templated content, search for all notes containing a project name to compile status, or reload and test a plugin after code changes.

Quick Start

Use the obsidian CLI to search the vault for notes matching "project plan" and open the top result.

Frequently Asked Questions about obsidian-cli

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

FAQPage Schema
How do I automate note creation and batch searches in an Obsidian vault?

You can automate Obsidian vault workflows by using the obsidian CLI to read, create, and append files without the GUI. It supports scripting vault-wide searches and targeting files by name or path for batch edits.

What is the best way to debug an Obsidian plugin during development?

The best way to debug an Obsidian plugin is using command-line developer commands to reload plugins, capture runtime errors, and inspect the DOM. You can also run JavaScript in the app context and take screenshots.

Can I manage Obsidian properties and tags from the command line?

Yes, you can manage Obsidian properties and tags from the command line. The CLI allows you to update properties and list backlinks for task and project tracking directly from your terminal.

Do I need a running Obsidian instance to use the command-line interface?

Yes, you need a running Obsidian application and an accessible obsidian CLI to interact with your vault. The CLI relies on the active application to execute commands, manage content, and perform developer debugging.

How do I search for notes containing a specific project name in Obsidian?

Search for notes containing a specific project name in Obsidian by running a vault-wide search via the CLI. You can compile status by searching for all notes matching the project name and opening the top result.