Obsidian
- 3.7k installs
- 385k repo stars
- Updated August 3, 2026
- steipete/clawdis
Obsidian is an agent skill that runs the official obsidian CLI to read, search, create, edit, and manage notes, tasks, links, and properties in a live Obsidian vault.
About
Obsidian is an agent skill that drives the official obsidian command-line interface for vault work on a running Obsidian desktop app. It documents requirements for Obsidian 1.12.7 or newer, CLI registration on PATH, and vault resolution via file or path parameters. Covered operations span open and read, JSON search, create and append, move and delete, daily notes, task completion, property get and set, backlinks, unresolved links, plugin reload, and developer eval helpers. The skill distinguishes file-based resolution from exact vault-relative paths, prefers CLI commands for Obsidian-aware moves and property updates, and allows direct Markdown edits for bulk text when the vault path is known. macOS registration creates /usr/local/bin/obsidian; Linux copies the binary to ~/.local/bin/obsidian. Developers reach for it when automating note search, task triage, property updates, or vault maintenance without third-party obsidian-cli wrappers.
- Uses the official obsidian CLI against a running Obsidian 1.12.7+ desktop app.
- Covers search, create, append, move, delete, daily notes, tasks, properties, and backlinks.
- Documents file versus path resolution and when to prefer CLI over direct Markdown edits.
- Includes developer commands for plugin reload, dev errors, screenshots, and eval snippets.
- Explicitly avoids third-party obsidian-cli unless the user requests it.
Obsidian by the numbers
- 3,656 all-time installs (skills.sh)
- +161 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #97 of 687 Office & Documents skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 3, 2026 (Skillselion catalog sync)
obsidian capabilities & compatibility
- Capabilities
- search vault notes with json or plain output · create, append, move, and delete markdown notes · read and update note properties and backlinks · manage daily notes and checkbox tasks · run developer diagnostics against the obsidian a
- Works with
- obsidian
- Use cases
- project management · planning · documentation
What obsidian says it does
Obsidian 1.12.7+ installed.
npx skills add https://github.com/steipete/clawdis --skill obsidianAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 3.7k |
|---|---|
| repo stars | ★ 385k |
| Security audit | 2 / 3 scanners passed |
| Last updated | August 3, 2026 |
| Repository | steipete/clawdis ↗ |
How do I automate Obsidian vault reads, searches, task updates, and property changes without hand-editing files or using unofficial CLI tools?
Read, search, create, edit, and manage Obsidian vault notes, tasks, links, and properties through the official obsidian CLI.
Who is it for?
Developers with Obsidian CLI enabled who want scripted vault search, note creation, task completion, and property management from an agent.
Skip if: Headless vault editing without the Obsidian app running, canvas-only workflows, or teams standardized on third-party obsidian-cli wrappers.
When should I use this skill?
User asks to search an Obsidian vault, create or append a note, complete a task line, set a property, or inspect backlinks from an agent session.
What you get
Vault notes and tasks updated through Obsidian-aware CLI commands with search results, property values, backlinks, and edited Markdown returned to the agent.
- Search results
- Created or edited notes
- Updated task and property state
By the numbers
- Requires Obsidian 1.12.7 or newer
- Supports file and path resolution modes
- Documents macOS and Linux CLI registration paths
Files
Obsidian
Use the official obsidian CLI for Obsidian vault work. Vault files are plain Markdown, so direct file edits are still fine when safer/faster.
Requirements
- Obsidian 1.12.7+ installed.
- Settings -> General -> Command line interface enabled.
obsidianregistered on PATH.- Obsidian app running; the CLI connects to the running app.
Check:
obsidian version
obsidian helpmacOS registration creates /usr/local/bin/obsidian pointing at the app-bundled CLI. Linux registration copies the binary to ~/.local/bin/obsidian.
Vault model
- Notes:
*.md. - Config:
.obsidian/; avoid editing unless asked. - Canvases:
*.canvasJSON. - Attachments: vault-configured folder.
- Multiple vaults are common; pass
vault="<name>"when ambiguous.
Obsidian desktop tracks vaults here:
~/Library/Application Support/obsidian/obsidian.json
Command pattern
obsidian <command> [name=value] [flag]
obsidian vault="Notes" search query="meeting notes" format=jsonParameter values with spaces need quotes. Add --copy to copy output where useful.
Common commands
Open/read:
obsidian open file=Recipe
obsidian open path="Inbox/Idea.md" newtab
obsidian read
obsidian read file=RecipeSearch:
obsidian search query="TODO" matches
obsidian search query="status::active" format=json
obsidian search:open query="project notes"Create/modify:
obsidian create name="New Note"
obsidian create path="Inbox/Idea.md" content="# Idea"
obsidian append file=Note content="New line"
obsidian prepend file=Note content="After frontmatter"Move/delete:
obsidian move file=Note to=Archive/
obsidian move path="Inbox/Old.md" to="Projects/New.md"
obsidian delete file=NoteDaily/tasks:
obsidian daily
obsidian daily:read
obsidian daily:append content="- [ ] Review inbox"
obsidian tasks all todo
obsidian task file=Note line=8 doneProperties/links:
obsidian tags all counts
obsidian property:read file=Note name=status
obsidian property:set file=Note name=status value=done
obsidian backlinks file=Note
obsidian unresolved verbose countsDeveloper/debug:
obsidian plugin:reload my-plugin
obsidian dev:errors
obsidian dev:screenshot file=shot.png
obsidian eval "app.vault.getFiles().length"Notes
file=<name>uses Obsidian-style file resolution;path=<vault-relative.md>is exact.- Prefer CLI move/delete/property commands for Obsidian-aware updates.
- Prefer direct Markdown edits for bulk text changes after locating the vault path.
- Do not rely on third-party
obsidian-cliunless user explicitly asks for it.
Related skills
Lark DocGenerate, update, and maintain structured documentation directly inside Lark/Feishu using natural language and agentic workflows.494kLark DriveLet their coding agents read, create, update and search documents stored in Lark (Feishu) Drive directly from prompts.493kLark SheetsConnect Claude, Cursor or other agents directly to Feishu/Lark spreadsheets for live data reads, writes, and structured automation.493kLark WikiGenerate, update, and sync structured knowledge bases inside Lark (Feishu) directly from code, specs, or agent output.493kLark WhiteboardGenerate, edit, and collaborate on visual diagrams and flowcharts directly inside Claude, Cursor or other agents.493kLark SlidesInstantly generate polished, professional slide decks from specs, roadmaps, or meeting notes using Lark/Feishu.493kForks & variants (1)
Obsidian has 1 known copy in the catalog totaling 35 installs. They canonicalize to this original listing.
- smithery.ai - 35 installs
How it compares
Official Obsidian CLI integration rather than generic filesystem Markdown edits or unofficial CLI wrappers.
FAQ
What does Obsidian require before the CLI works?
Obsidian 1.12.7 or newer, CLI enabled in Settings, the obsidian binary on PATH, and the desktop app running.
Should I edit vault files directly or use the CLI?
Prefer CLI move, delete, and property commands for Obsidian-aware updates; direct Markdown edits are fine for bulk text once the vault path is known.
Does this skill support third-party obsidian-cli?
No. It documents the official obsidian CLI only unless the user explicitly asks for a third-party tool.
Is Obsidian safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.