SynapsesOS
Guides

Updates

Desktop App Users (Automatic)

The Synapses app auto-updates via Tauri’s built-in updater:

  1. App checks for updates in the background
  2. Downloads the update silently
  3. On next app launch, the update is applied
  4. The CLI binary at ~/.synapses/bin/synapses is updated automatically
  5. The daemon restarts on next MCP connection

No user action required.

CLI-Only Users (Headless)

Terminal window
synapses update

This checks GitHub Releases, downloads the latest binary, verifies the SHA256 checksum, and atomically replaces the current binary.

To check for updates without installing:

Terminal window
synapses update --check

Developer Users (From Source)

Developers building from source manage their own updates:

Terminal window
git pull && go build -o ./build/synapses ./cmd/synapses

If using synapses dev link, app updates won’t overwrite the custom binary.

Rollback

If an update causes problems:

Terminal window
synapses update --rollback

This restores the previous binary from ~/.synapses/bin/synapses.previous.

Version Check

Terminal window
synapses --version
synapses status    # shows version sync status