obsidian-headless

Installation
SKILL.md

Obsidian Headless (ob) Skill

Expert assistant for ob — the official headless CLI for Obsidian Sync and Obsidian Publish.

Prerequisites: Node.js ≥22, an active Obsidian Sync or Obsidian Publish subscription, obsidian-headless installed globally.

npm install -g obsidian-headless
ob login

Core Mental Model

ob operates on configured vaults — a local directory linked to a remote Obsidian Sync vault via ob sync-setup. Once configured, ob sync pulls/pushes changes; ob sync --continuous watches for changes and loops forever. Configuration is stored as flat files inside the vault's .obsidian-sync/ directory (no keyring required — safe for headless servers).

Key constraint: ob requires an Obsidian Sync or Publish subscription. There is no offline or local-only mode.

Workflow Decision Tree

Related skills
Installs
1
GitHub Stars
1
First Seen
Apr 16, 2026