global-setup-sync

Sync Claude configuration and skills across machines using one-way replication from your Mac to a remote host, preserving settings, skills, and MCP configurations. This process uses rsync-based transfer to mirror the ~/.claude/ directory while preventing accidental overwrites of remote changes.

Yes, you can selectively sync specific Claude settings by choosing categories such as skills, settings, mcp, claude-md, hooks, and templates. This selective category syncing allows you to target only the configuration areas you want to replicate to the remote machine.

The best way to preview configuration changes before a remote sync is to use a dry-run option. This generates a manifest and validates the transfer plan beforehand, allowing you to review exactly what will be mirrored without applying any actual changes to the target machine.

Syncing the Claude directory creates automatic backups before applying changes to ensure safety. This backup mechanism, combined with conflict detection and resolution, guarantees that your previous remote configuration can be rolled back if the incremental sync produces unexpected results.

One-way sync prevents overwriting remote Claude configuration changes because data flows strictly from the Mac to the ai-slave. This directional replication ensures that any modifications made directly on the remote machine are protected from being overwritten by the source machine's state.

You should not use one-way replication for Claude setup backup when you need bidirectional synchronization or actively edit configuration on the remote machine. Since replication only mirrors the source state, any remote changes not present on the Mac will be lost during the sync process.