All products

Sync Obsidian notes with an AI agent

Set up a server copy of a vault, check its sync status and preview the separate list of notes marked for a Publish site.

To sync Obsidian notes with an AI agent, choose a remote vault and the folder that should hold its server copy. The obsidian-headless skill uses Obsidian’s command-line client, so the desktop app can stay closed. A one-off sync is useful for checking the initial setup before starting a continuous process.

A team handbook illustrates why sync and publication need separate choices. Drafts can belong in the shared vault while only approved notes belong on the public site. You can preview publication, check the destination site and see which marked notes would change before giving approval.

What it does

  • Connect a named remote vault to a local directory.
  • Run a one-off sync and inspect the resulting status.
  • Choose the attachment types and folders to include.
  • Review the effect of a pull-only or bidirectional setup.
  • Preview changes to an Obsidian Publish site before sending them.

Install and use

  1. Install the skill and official Obsidian Headless package with Node.js 22 or later. Sync and Publish each require the corresponding subscription. Sign in privately in your terminal.
  2. Back up the folder, then ask “Sync the research vault to this server path once and show its status.”
  3. For publication, review the dry run and the site name before approving the selected notes.

FAQ

Source

Made by Steph Ango and Obsidian contributors. Original skill: obsidian-headless, published on GitHub under the MIT licence.

View on GitHub