url/Obsidian-CLI-skill
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a484379635c77c33eb4425d3190eaeb42bf30ec6
Obsidian-CLI-skill/references/command-reference.md
T
pablo-mano a484379635 Add obsidian-cli skill (v1.12+) 
Initial commit with SKILL.md and full command reference for the
official Obsidian CLI — covering notes, daily notes, search,
properties, tags, tasks, links, sync, plugins, and developer tools.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-27 20:32:14 +01:00

11 KiB
Raw Blame History

Obsidian CLI — Full Command Reference

Complete reference for all official Obsidian CLI commands (v1.12+).

Syntax: obsidian [vault] <command> [subcommand] [key=value ...] [flags]

All parameters use key=value syntax. Quote values containing spaces: content="hello world".

Table of Contents

  1. Files
  2. Daily Notes
  3. Search
  4. Properties
  5. Tags
  6. Tasks
  7. Links
  8. Bookmarks
  9. Templates
  10. Plugins
  11. Sync
  12. Themes
  13. Developer
  14. Vault & System

Files

File operations: read, write, create, move, delete, list.

Reading Notes

obsidian read path="folder/note.md"

Prints raw markdown content of a note to stdout. Path is vault-relative.

Creating Notes

obsidian create path="folder/note" content="# Title\n\nBody text"
obsidian create path="folder/note" template="template-name"
  • Path should not include .md — it is appended automatically.
  • Use template= to create from a template file.
  • Use content= to set initial content directly.

Appending & Prepending

obsidian append path="folder/note.md" content="Appended text"
obsidian prepend path="folder/note.md" content="Prepended text"
  • append adds content at the end of the file.
  • prepend adds content after the frontmatter (not at byte 0).

Moving & Renaming

obsidian move path="old/path/note.md" name="new-name"
  • name= is the new filename (moves/renames).
  • The target path must include the .md extension when specifying a full path.

Deleting

obsidian delete path="folder/note.md"           # Moves to trash
obsidian delete path="folder/note.md" permanent  # Permanent deletion

File Discovery

obsidian files                       # List all files in vault
obsidian files ext=md                # Filter by extension
obsidian files folder="subfolder"    # Files in specific folder
obsidian files total                 # Just the file count
obsidian files format=json           # JSON output
obsidian folders                     # List all folders
obsidian file path="folder/note.md"  # File info (size, created, modified dates)

Daily Notes

Operations on the daily note (requires Daily Notes core plugin enabled).

obsidian daily                           # Open today's daily note in Obsidian
obsidian daily:read                      # Print today's daily note content to stdout
obsidian daily:append content="text"     # Append content to today's note
obsidian daily:prepend content="text"    # Prepend content (after frontmatter)

Notes:

  • daily:prepend inserts content after the frontmatter block, not at the very beginning.
  • If today's note doesn't exist, daily will create it (using the configured template if set).
  • Daily note format/folder are configured in Obsidian's Daily Notes plugin settings.

Search

Full-text search across the vault.

obsidian search query="search text"
obsidian search query="text" path="folder"         # Scope to folder
obsidian search query="text" limit=10               # Limit results
obsidian search query="text" format=json            # JSON output
obsidian search query="text" matches                # Include match context/snippets
obsidian search query="text" case                   # Case-sensitive search

Parameters:

  • query= — Search term (required)
  • path= — Restrict search to a folder
  • limit= — Maximum number of results
  • format=json — Machine-readable JSON output
  • matches — Show matching line context
  • case — Enable case-sensitive matching

Properties

Manage frontmatter (YAML metadata) on notes.

Read All Properties

obsidian properties path="note.md"

Read Single Property

obsidian property:read path="note.md" name="status"

Set Property

obsidian property:set path="note.md" name="status" value="active"
obsidian property:set path="note.md" name="tags" value="[project, alpha]"
obsidian property:set path="note.md" name="date" value="2026-02-27"

Remove Property

obsidian property:remove path="note.md" name="draft"

Aliases

obsidian aliases path="note.md"

Lists all aliases defined in the note's frontmatter.

Tags

Tag discovery and filtering.

obsidian tags                          # List all tags in the vault
obsidian tags counts                   # Tags with usage counts
obsidian tags counts sort=count        # Sorted by frequency (most used first)
obsidian tags path="note.md"           # Tags in a specific file
obsidian tag name="project/alpha"      # List notes with a specific tag

Notes:

  • Nested tags are supported (e.g., project/alpha).
  • Tags from both frontmatter and inline #tag syntax are included.

Tasks

Query and manage checkbox tasks across the vault.

Querying Tasks

obsidian tasks                         # All incomplete tasks
obsidian tasks all                     # All tasks (complete + incomplete)
obsidian tasks done                    # Only completed tasks
obsidian tasks path="note.md"          # Tasks in a specific file
obsidian tasks daily                   # Tasks in today's daily note

Toggling Task Status

obsidian task path="note.md" line=12 toggle

Toggles the checkbox on the specified line number between - [ ] and - [x].

Links

Graph analysis and link management.

obsidian backlinks path="note.md"         # Notes linking TO this note
obsidian backlinks path="note.md" counts  # With link counts per file
obsidian links path="note.md"             # Outgoing links FROM this note
obsidian unresolved                        # All unresolved [[wikilinks]]
obsidian orphans                           # Notes with no incoming or outgoing links
obsidian deadends                          # Notes with no outgoing links

Bookmarks

Manage Obsidian bookmarks (requires Bookmarks core plugin).

obsidian bookmarks                     # List all bookmarks

Bookmarks commands let you view and manage bookmarked notes, searches, and groups. Use obsidian bookmarks --help for all available subcommands.

Templates

Work with note templates (requires Templates or Templater plugin).

obsidian templates                                      # List available templates
obsidian template:read name="weekly-review"             # Read template content
obsidian template:read name="weekly-review" resolve title="My Note"  # Render with variables
obsidian template:insert name="weekly-review"           # Insert template into active file

Parameters:

  • name= — Template name (without path prefix or extension)
  • resolve — Process template variables
  • Title and other variables can be passed as key=value for template rendering.

Plugins

Manage community and core plugins.

obsidian plugins                       # List all installed plugins
obsidian plugins:enabled               # Only enabled plugins
obsidian plugins versions              # Plugins with version numbers
obsidian plugin:enable id="canvas"     # Enable a plugin
obsidian plugin:disable id="canvas"    # Disable a plugin
obsidian plugin:install id="dataview"  # Install from community plugins
obsidian plugin:reload id="my-plugin"  # Reload a plugin (useful for dev)

Sync

Manage Obsidian Sync (requires active Sync subscription).

obsidian sync                                   # Show sync status summary
obsidian sync on                                # Resume syncing
obsidian sync off                               # Pause syncing
obsidian sync:status                            # Detailed sync status
obsidian sync:history path="note.md"            # Version history for a file
obsidian sync:read path="note.md" version=3     # Read a specific version
obsidian sync:restore path="note.md" version=3  # Restore a previous version
obsidian sync:deleted                           # List files deleted via sync

Themes

Manage appearance themes.

obsidian themes                        # List available/installed themes

Use obsidian themes --help for additional subcommands related to theme management (install, switch, etc.).

Developer

Debugging and development tools.

Screenshots

obsidian dev:screenshot path="screenshot.png"

Takes a screenshot of the Obsidian window and saves it.

JavaScript Evaluation

obsidian eval code="app.vault.getFiles().length"
obsidian eval code="app.vault.getMarkdownFiles().map(f => f.path).join('\n')"

Executes arbitrary JavaScript in the Obsidian app context. Has access to the full Obsidian API (app, app.vault, app.workspace, app.metadataCache, etc.).

Console & Errors

obsidian dev:console limit=20          # Recent console output
obsidian dev:errors                    # Recent error messages

Vault & System

Vault Information

obsidian vault                         # Current vault: name, path, file/folder counts
obsidian vaults                        # List all known vaults

Other Utilities

obsidian version                       # Obsidian version info
obsidian outline path="note.md"        # Heading structure of a note
obsidian wordcount path="note.md"      # Word and character count
obsidian recents                       # Recently opened files
obsidian reload                        # Reload the vault (re-index)

Output Formatting & Piping

The CLI outputs plain text by default, ideal for piping into Unix tools:

# Count notes in a folder
obsidian files folder="projects" | wc -l

# Find notes with a specific tag, then read them
obsidian tag name="urgent" | while read -r note; do
  echo "=== $note ==="
  obsidian read path="$note"
done

# Export search results as JSON and process with jq
obsidian search query="meeting" format=json | jq '.[].path'

# Filter console errors
obsidian dev:console limit=50 | grep -i error

Multi-Vault Usage

When working with multiple vaults, pass the vault name as the first argument (before the command):

obsidian "Personal" daily:read
obsidian "Work" search query="standup"
obsidian "Archive" files total

If the vault name contains spaces, quote it. The vault name must match what's shown in obsidian vaults.

Headless / Server Setup (Linux)

For running Obsidian CLI on a headless Linux server (useful for AI agent integration):

  1. Install the .deb package (not snap — snap confinement breaks IPC)
  2. Install and start xvfb: Xvfb :5 -screen 0 1920x1080x24 &
  3. Start Obsidian under xvfb: DISPLAY=:5 obsidian &
  4. Run CLI commands: DISPLAY=:5 obsidian daily:read

Systemd note: If running as a service, ensure PrivateTmp=false so the IPC socket is accessible.

Stderr filtering: Headless environments produce harmless GPU warnings. Filter with:

DISPLAY=:5 obsidian search query="test" 2>/dev/null
Reference in New Issue View Git Blame Copy Permalink