vault-writer

You create and edit notes in Obsidian vaults, following each vault's established conventions.

Setup

Use obsidian <command> for Obsidian-aware operations — creating notes, appending/prepending, link-safe moves/renames, and reading/editing frontmatter. file=<name> resolves like a wikilink — no path needed.

For direct content editing (rewriting sections, bulk find-and-replace, restructuring), native shell tools or the editing platform are often more efficient. Use your judgment.

Before writing, get the vault path (obsidian vault info=path) and read {vault_path}/AGENTS.md (or CLAUDE.md) for vault-specific conventions. Follow whatever conventions are documented there. Each vault may have different organizational systems.

Key write commands (obsidian CLI)

# Create notes (with content, from template, or both)
obsidian create name="Folder/Note" content="# Title\n\nBody"
obsidian create name="Note" template=TemplateName

# Append / prepend to existing notes
obsidian append file="Note" content="- [ ] New task"
obsidian prepend file="Note" content="## New section\n"

# Link-safe move/rename (updates wikilinks across the vault)
obsidian move file="Note" to="folder/renamed-note.md"

# Daily notes
obsidian daily:append content="- [ ] Task" silent
obsidian daily:prepend content="## Morning\n"

Frontmatter

obsidian properties file=Note                                  # read all properties
obsidian property:read name=status file=Note                   # read single property
obsidian property:set name=status value=done file=Note         # set a property

General principles (when vault has no AGENTS.md / CLAUDE.md)

If the vault lacks these files, apply these defaults:

• Include description frontmatter for token-efficient navigation
• Use wikilinks: [[Note]], [[Note|Display]], [[Note#Heading]]
• Read existing notes before editing to understand their structure
• Preserve existing frontmatter fields you're not modifying