Mac Sync helps keep important files and settings in sync between Macs. Each Mac has its own storage area. Browse another Mac to pull files, drop files onto it to send them, or queue a replacement for its next sync. Version history and Undo provide recovery safeguards.
Data-loss warning: Use at your own risk. Mac Sync can lose, corrupt, overwrite or delete files. Stephen Clarke and contributors disclaim liability to the extent permitted by law. Keep an independent, verified backup. Read the data-loss disclaimer.
Requires an Apple silicon Mac, macOS 13 or later, and Homebrew. Use a private Git repository (GitHub, GitLab, Bitbucket or another host), or a folder already synced by iCloud Drive, OneDrive or another provider.
brew tap stephenlclarke/tap
brew trust --formula stephenlclarke/tap/mac-spinner
brew install mac-syncFor the opt-in Current build, use mac-sync-current instead. Uninstall one channel before installing the other. See release channels.
Desktop build 63 has a memory-growth defect. Upgrade to version 1.2.0 or later before syncing with the desktop app. Until then, keep the app closed and use the CLI or background worker.
-
Open
mac-sync ui. The setup helper lets you create a private repository in your browser and clone it, or choose a cloud-synced folder. Use the same destination on each Mac and a unique This Mac identifier. -
In Sync Selection, choose the files and folders to sync, then save the selection. Presets can help you start.
-
Click Sync Now in Overview, or run a sync in Terminal:
mac-sync sync mac-sync status
Non-conflicting changes to selected home-folder files are applied automatically. Conflicts and deletions wait for review. You can choose review-only mode in Settings. Do not add private keys, tokens or credentials to the regular selection; use encrypted secrets instead.
Under Other Macs, select files and use Copy to This Mac to pull them. Drop regular files onto another Mac's view to send them. Select one stored file and use Send Files → Replace selected file to queue a replacement. The receiving Mac applies it on its next sync if selected and unchanged locally; otherwise it waits in Inbox. See sync, transfer and recovery.
To restore from another Mac, preview the changes first:
MAC_SYNC_DRY_RUN=1 mac-sync restore --select
mac-sync restore --selectRestore keeps existing local files unless you explicitly choose to replace them. See the restore guide before applying a snapshot.
Use Settings → Automatic sync → When files change to watch selected folders, combine repeated saves, and keep hourly safety and remote checks. Or choose a timed schedule. The same background worker runs without the desktop UI and exits between runs; watch mode keeps one idle observer.
Alternatively, use the hourly Homebrew service:
brew services start mac-syncChoose one scheduling method, not both. For Current, substitute mac-sync-current. See automatic sync for migration, retry and service instructions.
brew upgrade mac-syncFor Current, use brew upgrade mac-sync-current. Restart an existing Homebrew service after upgrading; older app-managed schedules may need to be saved once in Settings. See the upgrade and schedule guidance.
- Setup, sync and restore walkthrough
- Desktop app guide
- CLI reference
- Configuration and snapshot layout
- Troubleshooting and known issues
- Development and API documentation · Releases and rollback
Copyright © 2026 quux.io. Licensed under AGPL-3.0-or-later. See notices.