wadackel/dotfiles/obsidian-cli
Claude Code and agent skill by wadackel/dotfiles
- community
Checking that the SKILL.md file is still in the repository.
Interact with the running Obsidian vault via the `obsidian` CLI: read, create, append, search, rename, move notes; manage daily notes; list files and folders; set/read frontmatter properties; list tags. Auto-loads whenever the user wants to save content to Obsidian, take or capture a note, append to today's daily note, search the vault, look up or quote an existing vault note, or open a note in Obsidian — even when the user does not mention the CLI by name. Triggers include "save to Obsidian", "note this", "take a note", "add to today's note", "search my vault", "what did I write about X", "open in Obsidian", "rename this note", "Obsidianに保存", "メモして", "メモを取って", "メモに残して", "デイリーノートに追記", "今日のノートに追加", "vaultを検索", "Obsidianのノートを読んで", "Obsidianで開いて", "ノートをリネーム", or any request that names a vault file, a vault folder (e.g. `00_Inbox/`, `99_Tracking/Daily/`), a daily/weekly note, or a wikilink target.
Install
npx vskill@latest install wadackel/dotfiles/obsidian-cliSKILL.md
The same SKILL.md was published earlier as wadackel/dotfiles/obsidian-cli.
Obsidian CLI
Use the obsidian CLI to interact with a running Obsidian instance.
Out of scope: the vault's private directory
05_Private/ holds identity documents. ~/.claude/settings.json denies Read and Edit there, which also covers Glob and Grep — but none of it applies to this CLI. It goes through Bash, and it resolves by note name rather than by path, so obsidian read reaches that directory exactly the way a wikilink does.
Nothing stops you here. There is no permission error to run into; the discipline is yours to keep.
Never use this CLI to read, search, append to, or create anything under that directory. Above all, never write one of its filenames into output — an answer, a note, a log, a report, a commit message. The name is the exposure, and it is the one part of this a machine still checks (llm-wiki's wiki-doctor.ts). If a note turns out to live there, say so without naming it and move on.
When you already know a note's path, read it with path= rather than file=. file= resolves by name the way a wikilink does, so you cannot see which directory it lands in until the content is already back.
Prerequisites
Obsidian must be running. The CLI communicates with the active Obsidian app. If Obsidian is not open, all commands will fail.
Target vault: Main (default — no vault= needed in most cases).
Syntax
Parameters take a value with =. Quote values with spaces:
Flags are boolean switches with no value:
File Targeting
file=<name>— resolves like a wikilink (name only, no path or extension)path=<path>— exact path from vault root (e.g.folder/note.md)
When neither is given, the active file is used.
Content Escaping (Important)
When passing content to create, append, or prepend:
- Use
\nfor newlines,\tfor tabs (the CLI interprets these sequences) - Escape
"inside the content string as\" - Escape
$as\$to prevent shell variable expansion - Backticks inside content should be escaped as `
\`` - Content containing
!(e.g., Obsidian embedded links![[file#heading]]) triggers bash history expansion, corrupting!to\!. Prefix withset +H:set +H && obsidian create path="..." content="..." overwrite
Example — creating a note with frontmatter and body:
Note Formatting Rules
When creating notes (obsidian create), follow the formatting rules defined in obsidian-notes:
- h1 → filename: If source content has
# Title, use it as the filename and remove from content - Frontmatter: Always include empty
aliases:,tags:,description:fields — do NOT populate them - Start from h2: Note body begins with
##, never#
Common Commands
Vault Directory Structure
| Directory | Purpose | |
|---|---|---|
00_Inbox/ | Default destination for new files | |
99_Tracking/Daily/ | Daily notes (YYYY-MM-DD.md) | |
99_Tracking/Weekly/ | Weekly notes (YYYY-WNN.md) |
Full directory listing: see obsidian-notes.
Run obsidian help to see all available commands with full parameter documentation.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckinghome/programs/agents/skills/obsidian-cli/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/wadackel/dotfiles/obsidian-cli)