obsidian-cli

Manage Obsidian vault notes, tasks, and properties through the Obsidian CLI.

5|Updated Sep 24, 2017
One-click install
npx skills add https://github.com/madyankin/dotfiles --skill obsidian-cli-madyankin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-cli
Source: https://github.com/madyankin/dotfiles/tree/main/.config/agents/skills/obsidian-cli
Command: npx skills add https://github.com/madyankin/dotfiles --skill obsidian-cli-madyankin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Working with an Obsidian vault from an AI assistant normally requires manual file handling and guesswork about paths. This Skill provides structured command-line access to a running Obsidian instance for reading, creating, searching, and updating notes without leaving the terminal. ## Core Features & Use Cases - Vault Operations: Read, create, append to, and search notes, manage daily notes, tasks, tags, backlinks, and YAML properties via the obsidian CLI. - Plugin Development Workflow: Reload plugins, capture errors, take screenshots, inspect the DOM, and check console output during plugin or theme development. - Safety Guardrails: Enforces explicit user confirmation before running privileged commands like obsidian eval or CDP debugger commands, and validates vault-relative paths. - Use Case: Ask the assistant to append a task to today's daily note, search the vault for a topic, or set a note's status property, and it executes the correct CLI command with proper file and vault targeting. ## Quick Start Ask the assistant to search your Obsidian vault for notes about a topic or append a new task to today's daily note.

Frequently Asked Questions about obsidian-cli

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

FAQPage Schema
How do I search my Obsidian vault from the command line?▼

Run `obsidian search query="your term" limit=10` to search vault content from the terminal. You can target a specific vault by prefixing the command with `vault="Vault Name"`, and add `--copy` to copy results to the clipboard.

How do I create or append to Obsidian notes with the CLI?▼

Use `obsidian create name="Note" content="# Hello"` to create a note and `obsidian append file="Note" content="New line"` to add content. Use `silent` to prevent files from opening and `overwrite` to replace existing content.

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

No, the obsidian CLI requires a running Obsidian instance to function. The included check script verifies both that the CLI is installed and that the Obsidian process is running before executing commands.

How do I target a specific vault or file with obsidian CLI commands?▼

Pass `vault="Name"` as the first parameter to choose a vault, otherwise the most recently focused vault is used. Target files with `file=` for wikilink-style name resolution or `path=` for an exact vault-relative path.

Is it safe to use obsidian eval for running JavaScript?▼

The `obsidian eval` command executes arbitrary JavaScript with full Node.js access, equivalent to running code directly on your machine. It should only run after showing the exact code to the user and receiving explicit confirmation.