Obsidian Headless is an agent skill for the ob command line tool, which runs Obsidian Sync and Obsidian Publish without the desktop app. It covers logging in, creating and linking vaults, running one-off or continuous syncs, changing sync settings and publishing notes to a site.
It sets limits for the assistant: the user types passwords, a dry run comes before a publish, and risky sync modes need confirmation.
What You Get
- Command examples for sync, sync settings and publish
- Safety rules for credentials, vault paths and remote changes
- Notes on Node.js 22 and the subscriptions Sync and Publish need
Common Use Cases
- Syncing a vault on a server
- Publishing notes from CI
- Changing Sync or Publish settings
What Makes It Unique
It is written around caution with accounts and remote state. It says to pass the vault path explicitly, back up before a first sync, and never use desktop Sync and Headless Sync on the same vault on one device.
Under The Hood
The skill is one SKILL.md with no scripts. The assistant runs the ob command in a shell, which signs in to your Obsidian account and sends vault files to Obsidian Sync or Publish servers. Commands can change remote vault and site state, and the install needs npm.