synthesis-mac-sync

Installation
SKILL.md

Synthesis Mac Sync

A methodology for keeping multiple Macs in sync using iCloud for configuration files and Git for repositories. Designed to run fully automated via an AI coding assistant — the user says "run my mac-sync" and the assistant handles everything.

This skill provides the protocol — the sync methodology, safety rules, conflict resolution, and manifest format. Your personal config file (a README or manifest in your iCloud sync folder) provides the specifics: which files, which machines, which repos.

Configuration

These values are user-specific. Update them for your environment.

Setting Value Description
icloud_sync_folder ~/Library/Mobile Documents/com~apple~CloudDocs/workspaces/[username]/mac-sync/ iCloud Drive folder for synced config files
git_scan_root ~/workspaces/ Root directory for git repository discovery
git_scan_max_depth 3 Maximum depth for recursive .git directory search
git_repos_manifest git-repos.yaml Legacy central manifest (transitional; see v1.6.0 section)
workspace_repo_manifest <workspace>/.agents/repos.yaml Per-workspace repo manifest (v1.6.0; canonical for repo entries)

Installs
36
GitHub Stars
18
First Seen
Mar 20, 2026
synthesis-mac-sync — synthesisengineering/synthesis-skills