Vault Files

Obsidian Vault File Operations

When to Use This Skill

Comprehensive guidance for managing files, folders, and daily notes in Obsidian vaults using the official Obsidian CLI.

Prerequisites

• Obsidian desktop v1.12.4+ installed
• CLI enabled in Settings → General → Command line interface
• Obsidian must be running (CLI communicates with the running instance)

Path & Flag Conventions

• All paths are vault-relative — use folder/note.md, not absolute filesystem paths
• file=<name> resolves like a wikilink (no extension needed); path=<full/path.md> is exact
• Most commands default to the active file when neither file= nor path= is supplied
• create omits .md from name= (added automatically); move requires .md in to=
• Quote values containing spaces: file="My Note Title"
• Newlines: \n, tabs: \t
• Flags are bare words — overwrite, open, newtab, permanent, inline, total. The single exception is --copy (a universal output flag).
• Multi-vault: prefix vault=<name> before the command — see vault-management

Core File Operations

List Files & Folders

# All files in vault
obsidian files

# Files in specific folder
obsidian files folder=Projects/Active

# Filter by extension
obsidian files ext=canvas

# Total note count
obsidian files total

# All folders, or a tree view
obsidian folders
obsidian folders format=tree

File Info

# Info on the active file (path/name/extension/size/created/modified)
obsidian file

# Info on a specific file
obsidian file file=Recipe
obsidian file path="Notes/Recipe.md"

# Folder info
obsidian folder path="Projects"
obsidian folder path="Projects" info=files
obsidian folder path="Projects" info=size

# Word and character counts
obsidian wordcount file=Recipe
obsidian wordcount file=Recipe words
obsidian wordcount file=Recipe characters

Read a Note

# Read by name (wikilink resolution)
obsidian read file="Note Name"

# Read by exact path
obsidian read path="Projects/spec.md"

# Read the active file (no args)
obsidian read

# Copy result to clipboard
obsidian read file="Note Name" --copy

Create a Note

# Basic create (no .md needed)
obsidian create name="New Note"

# Create in folder with content
obsidian create name="Projects/Feature Spec" content="# Feature Spec\n\nDescription here."

# Create from a template (see also: templates skill)
obsidian create name="Meeting Notes" template="Meeting"

# Overwrite existing, then open it
obsidian create name="Draft" content="Fresh start" overwrite open

Append / Prepend

# Add to end of note
obsidian append file="Daily Log" content="\n## New Section\nContent here."

# Append without an extra newline
obsidian append file="Daily Log" content="more text" inline

# Add after frontmatter (prepend skips YAML)
obsidian prepend file="Inbox" content="- [ ] New task\n"

Open a Note

obsidian open file="Recipe"
obsidian open path="Notes/Recipe.md" newtab

Move / Rename

# Move to a folder (requires .md extension on target)
obsidian move file="Draft" to=Archive/Draft.md

# Move + rename in one shot
obsidian move file="Old Name" to="Archive/New Name.md"

# Rename in place — preserves extension automatically
obsidian rename file="Old Name" name="New Name"

move and rename automatically update internal links if Settings → Files & Links → Automatically update internal links is enabled.

Delete

# Move to system / Obsidian trash
obsidian delete file="Old Note"

# Permanent deletion (skips trash, irreversible)
obsidian delete file="Old Note" permanent

For undoing accidental deletes, see file-history (history:restore, sync:restore, sync:deleted).

Daily Notes

# Open today's daily note (creates if needed)
obsidian daily

# Get the expected daily note path (without creating)
obsidian daily:path

# Read today's content
obsidian daily:read

# Append / prepend
obsidian daily:append content="- Met with team about roadmap"
obsidian daily:prepend content="## Morning Goals\n- Review PRs"

# Open in a split or new window
obsidian daily paneType=split
obsidian daily paneType=window

The CLI does not expose a date= parameter on daily itself; for past dates use obsidian open path="Daily/2026-02-15.md" (with the actual folder/format from your Daily Notes settings).

Random & Unique Notes

# Open a random note
obsidian random

# Limit randomness to a folder
obsidian random folder=Inbox newtab

# Read a random note (returns content + path)
obsidian random:read folder=Inbox

# Unique note creator (Zettelkasten-style)
obsidian unique name="Idea" content="# Spark\n\n" open

Web Viewer

# Open a URL in Obsidian's built-in web viewer
obsidian web url="https://obsidian.md/help/cli"

# In a new tab
obsidian web url="https://obsidian.md/help/cli" newtab

Useful for keeping reference docs side-by-side with notes without leaving Obsidian.

App Maintenance

# Obsidian app version
obsidian version

# Reload the active window (cheap; preserves vault)
obsidian reload

# Full app restart (heavier; for plugin reloads, prefer plugin:reload)
obsidian restart

Common Flags

Agentic Optimizations

Related Skills

• search-discovery — Find notes by content, tags, links, or grep-style context
• properties — Manage YAML frontmatter on notes
• tasks — Task management across the vault
• bases — Query notes via Base views
• templates — List, preview, and insert templates
• file-history — Restore previous versions or recover deletes
• vault-management — Multi-vault vault= prefix and vault info