laurigates/publish-sync

Obsidian Publish & Sync

When to Use This Skill

| Use this skill when... | Use the alternative instead when... | |---|---| | Listing, adding, removing, or auditing the change set on Obsidian Publish | Creating or moving the underlying notes themselves — use vault-files | | Pausing/resuming Obsidian Sync or checking sync status & usage | Restoring a previous sync version of a file — use file-history | | Recovering a file that sync deleted | Recovering a file from local File Recovery — use file-history | | Auditing which notes are currently public vs private | Discovering orphaned or unresolved-link notes — use search-discovery |

Manage Obsidian Publish and Obsidian Sync services from the CLI. Sync version history (per-file diff and restore) lives in file-history.

Prerequisites

• Obsidian desktop v1.12.4+ with CLI enabled
• Obsidian must be running
• Active Obsidian Publish and/or Sync subscription for the respective commands

Obsidian Publish

Site Info

# Slug, URL, status of the connected Publish site
obsidian publish:site

List & Compare

# All currently published files
obsidian publish:list
obsidian publish:list total

# What would change on next publish (new / changed / deleted)
obsidian publish:status
obsidian publish:status new
obsidian publish:status changed
obsidian publish:status deleted
obsidian publish:status total

Publish & Unpublish

# Publish the active file
obsidian publish:add

# Publish a specific file
obsidian publish:add file="Public Note"
obsidian publish:add path="blog/post.md"

# Publish *all* changed files in one shot
obsidian publish:add changed

# Unpublish
obsidian publish:remove file="Draft Post"

# Open the file's published page in the browser
obsidian publish:open file="Public Note"

Obsidian Sync

Status & Pause/Resume

# Sync state, last sync time, usage
obsidian sync:status

# Pause / resume sync
obsidian sync off
obsidian sync on

Files Deleted via Sync

# Files removed via sync (recoverable)
obsidian sync:deleted
obsidian sync:deleted total

To restore one of those files, use file-history: obsidian sync:restore file=X version=N.

Per-file Sync Versions

For listing, reading, or restoring a specific sync version of a file, use the file-history skill (sync:history, sync:read, sync:restore, sync:open).

Common Patterns

"Publish every note tagged #publish"

# Find candidates
obsidian search query="tag:#publish" format=json

# Or rely on the change set after the user tags them
obsidian publish:status new
obsidian publish:add changed

"Pre-publish dry run"

obsidian publish:status            # all changes
obsidian publish:status new        # adds only
obsidian publish:status deleted    # removes only

"Snapshot the public surface"

obsidian publish:list > published-$(date +%F).txt
obsidian publish:site

"Recover a synced file the agent deleted"

obsidian sync:deleted
# Identify the file, then restore via file-history:
obsidian sync:restore file="Notes/Important" version=1

Agentic Optimizations

| Context | Command | |---------|---------| | Site info | obsidian publish:site | | List published | obsidian publish:list | | What's changed since last publish | obsidian publish:status | | New files only | obsidian publish:status new | | Publish all changes | obsidian publish:add changed | | Publish one file | obsidian publish:add file=X | | Unpublish | obsidian publish:remove file=X | | Sync status | obsidian sync:status | | Pause sync | obsidian sync off | | Resume sync | obsidian sync on | | Sync-deleted files | obsidian sync:deleted |

Related Skills

• vault-files — Create or modify notes before publishing
• properties — Set publish-related frontmatter on notes
• search-discovery — Find notes tagged for publishing
• file-history — Per-file sync history (sync:history, sync:read, sync:restore)