Add SpacesSync Spoon

[johntrandall]

Summary

• Adds SpacesSync, a Spoon that synchronizes macOS Spaces across monitors in configurable sync groups
• When you switch Spaces on one monitor, all others in the same group follow to the matching Space index
• Supports arbitrary sync groups (pairs, triples, etc.) with monitors identified by position number (reading order)

Details

• Uses hs.spaces.watcher to detect space changes, hs.spaces.gotoSpace() to sync targets
• Chains switches with configurable delay (macOS silently drops rapid calls)
• Debounce prevents watcher from reacting to its own programmatic switches
• Checks macOS version (requires 15.0+) and Mission Control settings on start
• Preloads extensions at load time to avoid lazy-load latency during sync
• Uses hs.logger for structured logging, hs.spoons.bindHotkeysToSpec for hotkeys

Test plan

• Tested on macOS 15.5 (Sequoia) with Hammerspoon 1.1.1
• 4-monitor setup (4x LG SDQHD) with 3-monitor sync group
• Verified start/stop/toggle lifecycle
• Verified bindHotkeys with defaultHotkeys
• Verified docs.json generation (5 variables, 5 methods)
• Not tested on macOS 14 or 16 (blocks on <15, warns on untested versions)

Homepage: https://github.com/johntrandall/hammerspoon-spaces-sync

🤖 Generated with Claude Code