pilot-sync#

Bidirectional file synchronization between agents using conflict detection.

Commands#

Sync directory to remote#

bash

for file in /path/to/sync/*; do
  pilotctl --json send-file 1:0001.AAAA.BBBB "$file"
done

List received files#

bash

pilotctl --json received | jq -r '.received[] | {filename, size, from, timestamp}'

Watch directory for changes#

bash

fswatch -0 /path/to/sync | while read -d "" file; do
  pilotctl --json send-file 1:0001.AAAA.BBBB "$file"
done

Workflow Example#

Bidirectional sync with conflict detection:

bash

#!/bin/bash
SYNC_DIR="$HOME/shared-data"
REMOTE="1:0001.AAAA.BBBB"

# Build manifest
LOCAL_MANIFEST=$(find "$SYNC_DIR" -type f -exec sh -c \
  'printf "%s:%s:%s\n" "{}" "$(md5sum {} | cut -d\" \" -f1)" "$(stat -f %m {})"' \;)

# Send manifest and sync
pilotctl --json send-message "$REMOTE" --data "{\"type\":\"sync_init\",\"manifest\":\"$LOCAL_MANIFEST\"}"

# Start continuous sync
fswatch -0 "$SYNC_DIR" | while read -d "" changed_file; do
  pilotctl --json send-file "$REMOTE" "$changed_file"
done

Dependencies#

Requires pilot-protocol skill, jq, fswatch/inotifywait, md5sum, and stat.