BeClaude

obsidian-skill

New
GitHubDevelopmentby wizzy15

📝 Manage and organize Obsidian vaults with CLI tools for notes, tasks, tags, templates, and knowledge graph analysis.

First seen 5/25/2026

Overview

Obsidian CLI

Controls the running Obsidian app via IPC. First invocation launches Obsidian if not running.

Prerequisites

  1. Install Obsidian 1.12+
  2. Enable CLI: Settings → General → Command line interface → follow registration prompt
  3. Restart terminal (registration adds obsidian to PATH automatically)

Platform-specific PATH details:

  • macOS: appends /Applications/Obsidian.app/Contents/MacOS to ~/.zprofile
  • Linux: symlink at /usr/local/bin/obsidian (fallback ~/.local/bin/obsidian)
  • Windows: requires Obsidian.com redirector from Discord #insider-desktop-release

Syntax

code
obsidian <command> [vault=<name>] [file=<name>] [path=<path>] [flags] [--copy]
PatternBehavior
vault=<name>Target vault by name; defaults to cwd vault or active vault
file=<name>Wikilink-style resolution (no path/extension needed)
path=<path>Exact vault-relative path, e.g. path="Folder/Note.md"
totalReturn count instead of list
`format=json\text\csv\tsv\md`Output format (varies per command)
--copyCopy any command's output to clipboard
\n / \tNewline / tab in content strings
No file/pathDefaults to active file in Obsidian
Bare obsidianOpens interactive TUI with autocomplete + Ctrl+R history

Quick start

These five operations cover most agent tasks. For complete command reference, see the domain-specific guides below.

Read a note

bash
obsidian read file="Meeting Notes"
obsidian read path="Projects/Roadmap.md"
obsidian read                              # active file

Create a note

bash
obsidian create name="New Note" content="# Title\n\nBody"
obsidian create name="From Template" template="Meeting Notes" silent

Append / prepend

bash
obsidian append file="Journal" content="- New entry"
obsidian prepend file="Ideas" content="## Latest idea"
obsidian daily:append content="- 2pm: Call with team" silent

Search

bash
obsidian search query="project deadline"
obsidian search query="API" limit=10 format=json
obsidian search query="fix" matches         # include context

Tasks

bash
obsidian tasks all todo                     # vault-wide incomplete
obsidian tasks daily                        # today's daily note
obsidian task file="Todo" line=8 toggle     # toggle completion

Reference guides

Load these on demand based on the task:

TaskReference
Read, create, edit, move, delete notes; outline; word count; unique notesreferences/note-operations.md
Search, tags, properties, backlinks, orphans, unresolved links, aliasesreferences/search-metadata.md
Daily notes, tasks, templatesreferences/daily-tasks-templates.md
Vault info, files/folders, bookmarks, plugins, workspaces, themes, sync, publish, bases, dev toolsreferences/vault-management.md

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/obsidian-skill.md https://raw.githubusercontent.com/wizzy15/obsidian-skill/main/SKILL.md
3
Invoke in Claude Code
/obsidian-skill
View source on GitHub

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is obsidian-skill?

📝 Manage and organize Obsidian vaults with CLI tools for notes, tasks, tags, templates, and knowledge graph analysis.

How to install obsidian-skill?

To install obsidian-skill: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/obsidian-skill.md https://raw.githubusercontent.com/wizzy15/obsidian-skill/main/SKILL.md. Finally, /obsidian-skill in Claude Code.

What is obsidian-skill best for?

obsidian-skill is a skill categorized under Development. Created by wizzy15.