Agent skill · software engineering · steipete
xcode-sync
Xcode fleet sync: signed archives, compatibility, install, selection, first launch.
Why this skill is useful
Adds multiple executable scripts for Xcode fleet synchronization and auditing that are not commonly found in public documentation.
What it needs
Requires rsync, ssh installed locally. About 4k tokens when loaded. Last updated 2026-08-06. 6,510 stars on the source repository.
What this skill does
Xcode Sync Synchronize exact Xcode builds across Peter's supported Macs. Use $remote-mac for fleet topology and SSH rules. Inventory 1. Read ~/Projects/manager/computers.yaml; use live tailscale status --json for reachability/IPs. 2. Exclude handed-off and unknown hosts. Verify hostname, user, macOS, architecture, and hardware UUID before writes. 3. Deduplicate Tailscale nodes by hardware UUID; one Mac may have multiple live node records. 4. Run scripts/xcode-host-inventory.sh locally or remotely: Treat unreachable hosts as pending, not synchronized. Try live Tailscale IP, Tailscale SSH, then mDNS/LAN only when network topology permits. Simulator hygiene Every fleet Mac must pass the simulator-hygiene audit, including worker Macs where the correct result is not-applicable because Xcode and simctl are absent. Apple CoreSimulator's own classifications are authoritative: remove runtime images reported by simctl runtime delete --outdated --dry-run or --unusable --dry-run, plus simulator devices attached to unavailable runtimes. Do not classify a runtime as stale from its version number alone; stable and beta Xcodes can legitimately need different runtime generations on the same Mac. Run the dependency-light audit locally or stream it to a remote Mac: The audit exits 1 for drift. After verifying the host identity and current Xcode work, repair with --repair; the action deletes unavailable devices and Apple's outdated/unusable runtime candidates, then re-audits. It refuses repair while a simulator device is booted. Do not use age-based runtime deletion, --notUsedSinceDays, or all for routine fleet maintenance. Inspect source Prefer the user's downloaded .xip; do not redownload it. Require Apple Software signature. Compare ProductBuildVersion, not version label alone: two archives named Xcode 26.6 may contain different builds. Do not use DTXcodeBuild as the sync key; it can differ from the build reported by xcodebuild -version. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/xcode-sync