obsidian-cli

Interact with a running Obsidian vault via command-line for notes, tasks, plugins, and themes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a command-line interface to interact with a running Obsidian vault, removing friction for programmatic note management, fast searches, task updates, and plugin or theme debugging.

Core Features & Use Cases

  • Read and modify notes: create, read, append, and update notes by name or exact path, targeting the active file when unspecified.
  • Search and manage vault content: run queries across a vault, list backlinks, tags, tasks, and retrieve counts or summaries.
  • Developer and debugging tools: reload plugins, run JavaScript in the app context, capture screenshots, inspect DOM elements, and collect console errors for iterative plugin/theme development.
  • Use Case: automate daily note generation and task sync from external tools, perform bulk searches and updates across a vault, or iterate on plugin changes with rapid reload-evaluate-verify cycles.

Quick Start

Ask the obsidian-cli to create a new note titled My Note with the content Hello world in your active vault.

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 updates in an Obsidian vault?

Automate Obsidian note creation by using command-line interaction to read, create, append, and update notes by name or exact path. This requires an active Obsidian instance with CLI availability to target files programmatically and remove manual friction.

Can I run vault-scoped searches and list tasks from the command line?

Run vault-scoped searches from the command line to list backlinks, tags, and tasks, or retrieve counts and summaries. This enables fast queries across a running Obsidian vault without navigating the graphical interface for bulk content management.

What's the best way to debug and reload Obsidian plugins during development?

Debug Obsidian plugins by reloading them, running JavaScript in the app context, inspecting DOM elements, and capturing screenshots. This supports rapid reload-evaluate-verify cycles to iterate on plugin and theme changes directly on a running instance.

Does the Obsidian CLI require the app to be running to manage notes?

The Obsidian CLI requires an active, running Obsidian instance with CLI availability to manage notes. It interacts directly with the open vault, applying commands for file targeting, plugin reloads, and JavaScript evaluation within the live application context.

Why use a command-line interface instead of the Obsidian GUI for vault management?

Use a command-line interface for Obsidian vault management to automate daily note generation, sync tasks from external tools, and perform bulk searches. It removes friction for programmatic workflows that are difficult to execute manually through the GUI.