macsync/CLAUDE.md

@mac-sync

Unified macOS sync agent — collapses iMessage, iPhoto, and iMail into one app + one server.

See the plan: ~/.claude/plans/moonlit-swimming-deer.md

Structure

@packages/
  shared/       MacSyncShared SwiftPM target — transport, auth, chunking, local web server
  imessage/     IMessageSync SwiftPM target
  iphoto/       IPhotoSync SwiftPM target
  imail/        IMailSync SwiftPM target
src/client/     MacSyncApp executable (menu bar app)
src/server/     NestJS-style server (TypeScript)
deploy/         install.sh, LaunchAgent, systemd units
web/            React SPA (dashboard)

Dev

make build       # swift build --product MacSyncApp
make test        # swift test

Safety

• NEVER commit — external service handles commits
• NEVER pkill node
• NEVER use file: or link: in package.json