JonMcMillan

sync-envs

Read-only status/preview for claude-sync-by-skill — show what would change between this machine and the shared sync folder in both directions, without modifying anything. Use when the user types /sync-envs or asks to preview/check their Claude environment sync status. To actually move files, use /sync-env-up (push local → folder) or /sync-env-down (pull folder → local). For first-time configuration, run the engine with --setup.

sync-env-down

Pull the unified Claude environment (memory, plans, settings, skills, secrets) DOWN from the shared sync folder onto this machine, overwriting/updating local with the latest. Use when the user types /sync-env-down or says they just sat down at this machine and want to bring over the environment they were working on elsewhere / pull the latest from the sync folder. Always previews changes and confirms before any destructive deletion; never clobbers newer local work without flagging a conflict.

sync-env-up

Push this machine's Claude environment (memory, plans, settings, skills) UP to the shared sync folder, updating the unified copy with version + deletion checks. Use when the user types /sync-env-up or says they're done working on this machine and want to sync their environment up / push their changes to the sync folder so another machine can pull them. Always previews changes and confirms before any destructive deletion. Secrets are not pushed unless explicitly enabled.

sync-add-note

Leave a cross-device reminder note that surfaces on your OTHER machines the next time they run a sync-down. Use when the user types /sync-add-note or says they want to remember a follow-up task on another device / leave themselves a note for their next session elsewhere (e.g. "remind me to do X when I'm on the Surface"). The note does not surface on the machine that created it.

sync-notes

Show all currently active cross-device reminder notes held in the sync folder (from every machine, including this one). Read-only. Use when the user types /sync-notes or asks to see their outstanding sync notes / what reminders are pending across their devices. To leave a new note use /sync-add-note; notes are surfaced and resolved during /sync-env-down.