ABOUTME: Obsidian vault management via official CLI (1.12+)
ABOUTME: CRUD, search, daily notes, tags, properties, graph analysis, tasks, templates
Obsidian Vault Operations
CLI reference: See ../_OBSIDIAN.md for full command reference.
Integration: See ../_SECOND_BRAIN.md for category routing when adding knowledge.
Capabilities
- Note CRUD: create, read, append, prepend, move, delete
- Search: full-text with folder filtering, JSON output
- Daily Notes: read, append, prepend to today's note
- Tags & Properties: list, set, read, remove frontmatter properties and tags
- Knowledge Graph: backlinks, outgoing links, orphans, dead-ends, unresolved links
- Tasks: list, toggle, mark done/todo across vault or daily note
- Templates: list, read (with variable resolution), create from template
- History: diff versions, restore from file recovery or sync
Common Workflows
Quick capture to daily note
obsidian daily:append content="- [ ] <task or note>" silent
Find related notes
obsidian backlinks file=<name> counts
obsidian links file=<name>
Vault health check
obsidian orphans total
obsidian deadends total
obsidian unresolved verbose
Search and read
obsidian search query="<term>" matches limit=10
obsidian read file=<result>
Add knowledge to Second Brain
# 1. Read existing content to check for duplicates
obsidian read file="Second Brain - <Topic>"
# 2. Append extracted content (follow _SECOND_BRAIN.md template)
obsidian append file="Second Brain - <Topic>" content="<extracted>"
# 3. Update timeline
obsidian append file="Second Brain - Timeline" content="- **YYYY-MM-DD** | [Topic] | Source: ..."
Onboard project to vault
# Run the project onboarding protocol from _VAULT_CONTEXT.md
# Detects project info from CLAUDE.md, creates Overview/Log/Solutions, registers in MOC
# See _VAULT_CONTEXT.md "Project Onboarding" for full steps
Fallback: Direct File Access
When the Obsidian CLI is unavailable (app not running, CLI errors, tool not found), access vault markdown files directly.
Vault path: '/Users/maroffo/Library/Mobile Documents/iCloud~md~obsidian/Documents'
- Use Read/Write/Edit/Glob/Grep tools on
.md files in the vault path
- Note names map to
<vault>/<note name>.md (subfolders for organized notes)
- Frontmatter is standard YAML between
--- delimiters
- Daily notes:
<vault>/Daily Notes/YYYY-MM-DD.md
- Search: use Grep on vault path instead of
obsidian search
- Append: use Edit tool to add content at end of file
Rules
- Always use
silent flag for create/append when user doesn't need the note opened
- Prefer
file=<name> (wikilink resolution) over path= for convenience
- For Second Brain operations, follow
../_SECOND_BRAIN.md routing
- Multiline content: use
\n for newlines in content strings
- CLI first, direct file access as fallback. Try CLI; on failure, switch to direct access silently.
1---2name: obsidian3description: Obsidian vault operations via CLI. Use for note management, search, daily notes, knowledge graph analysis, tasks, properties. Not for Notion sync (use notion-sync).4---56# ABOUTME: Obsidian vault management via official CLI (1.12+)7# ABOUTME: CRUD, search, daily notes, tags, properties, graph analysis, tasks, templates89# Obsidian Vault Operations1011**CLI reference:** See `../_OBSIDIAN.md` for full command reference.12**Integration:** See `../_SECOND_BRAIN.md` for category routing when adding knowledge.1314## Capabilities15161. **Note CRUD**: create, read, append, prepend, move, delete172. **Search**: full-text with folder filtering, JSON output183. **Daily Notes**: read, append, prepend to today's note194. **Tags & Properties**: list, set, read, remove frontmatter properties and tags205. **Knowledge Graph**: backlinks, outgoing links, orphans, dead-ends, unresolved links216. **Tasks**: list, toggle, mark done/todo across vault or daily note227. **Templates**: list, read (with variable resolution), create from template238. **History**: diff versions, restore from file recovery or sync2425## Common Workflows2627### Quick capture to daily note28```bash29obsidian daily:append content="- [ ] <task or note>" silent30```3132### Find related notes33```bash34obsidian backlinks file=<name> counts35obsidian links file=<name>36```3738### Vault health check39```bash40obsidian orphans total41obsidian deadends total42obsidian unresolved verbose43```4445### Search and read46```bash47obsidian search query="<term>" matches limit=1048obsidian read file=<result>49```5051### Add knowledge to Second Brain52```bash53# 1. Read existing content to check for duplicates54obsidian read file="Second Brain - <Topic>"55# 2. Append extracted content (follow _SECOND_BRAIN.md template)56obsidian append file="Second Brain - <Topic>" content="<extracted>"57# 3. Update timeline58obsidian append file="Second Brain - Timeline" content="- **YYYY-MM-DD** | [Topic] | Source: ..."59```6061### Onboard project to vault62```bash63# Run the project onboarding protocol from _VAULT_CONTEXT.md64# Detects project info from CLAUDE.md, creates Overview/Log/Solutions, registers in MOC65# See _VAULT_CONTEXT.md "Project Onboarding" for full steps66```6768## Fallback: Direct File Access6970When the Obsidian CLI is unavailable (app not running, CLI errors, tool not found), access vault markdown files directly.7172**Vault path:** `'/Users/maroffo/Library/Mobile Documents/iCloud~md~obsidian/Documents'`7374- Use Read/Write/Edit/Glob/Grep tools on `.md` files in the vault path75- Note names map to `<vault>/<note name>.md` (subfolders for organized notes)76- Frontmatter is standard YAML between `---` delimiters77- Daily notes: `<vault>/Daily Notes/YYYY-MM-DD.md`78- Search: use Grep on vault path instead of `obsidian search`79- Append: use Edit tool to add content at end of file8081## Rules8283- Always use `silent` flag for create/append when user doesn't need the note opened84- Prefer `file=<name>` (wikilink resolution) over `path=` for convenience85- For Second Brain operations, follow `../_SECOND_BRAIN.md` routing86- Multiline content: use `\n` for newlines in content strings87- **CLI first, direct file access as fallback.** Try CLI; on failure, switch to direct access silently.
maroffo