obsync

What This Skill Does

The obsync skill is a powerful command-line utility designed for Obsidian users who need to maintain their markdown notes on headless Linux infrastructure. It serves as a bridge between the Obsidian Sync service and local storage, enabling seamless synchronization of vaults without requiring a graphical desktop environment. Unlike simple file-sync tools, obsync handles the complexities of Obsidian's E2E encryption (using AES-256-GCM) and native .obsidian/ directory structures, ensuring that your themes, plugins, and settings remain consistent across all your devices. It features robust connectivity, including automatic reconnection with exponential backoff and efficient delta-transfer syncing based on SHA-256 hashing to minimize bandwidth usage.

Installation

To add this skill to your OpenClaw environment, use the command: clawhub install openclaw/skills/skills/bpauli/obsync. Ensure your system has the necessary permissions to read/write files and access the network. For headless server deployments, execute loginctl enable-linger $USER to maintain the sync process while logged out, and set the environment variable export OBSYNC_KEYRING_BACKEND=file to accommodate the lack of a system-level GUI keyring.

Use Cases

• Continuous Backup: Keep your digital garden backed up on a remote server while simultaneously working on your laptop.
• Server-Side Automation: Use the watch mode to trigger server-side scripts (e.g., publishing notes to a static site) whenever a file change is detected.
• Multi-Device Parity: Maintain a 'master' vault on a headless server that stays in sync with your desktop and mobile applications.

Example Prompts

1. "Sync my 'Personal Vault' from Obsidian to the ~/notes directory on this server and save my encryption key."
2. "Check the status of my 'Journal' vault sync service and show me the most recent logs."
3. "Enable the continuous sync watch mode for my 'Projects' vault so my server always has the latest updates."

Tips & Limitations

• Performance: For large vaults, the initial pull may take time; utilize the verbose flag (-v) if you suspect stalls.
• Security: Always use the --save-password flag sparingly; ensure your server is adequately secured, as storing E2E keys in a file-based keyring requires appropriate directory permissions.
• Constraints: This tool requires an active Obsidian Sync subscription. It is optimized for Linux environments and may behave differently depending on the distribution's systemd implementation.