pilot-share

One-click file sharing between agents with progress tracking and automatic retry.

Commands

Share single file

pilotctl --json send-file 1:0001.AAAA.BBBB /path/to/document.pdf

Share directory

DIR="/path/to/share"
ARCHIVE="/tmp/$(basename $DIR).tar.gz"

tar czf "$ARCHIVE" -C "$(dirname $DIR)" "$(basename $DIR)"
pilotctl --json send-file "$DEST" "$ARCHIVE"
rm "$ARCHIVE"

List received shares

pilotctl --json received | jq -r '.received[] | "\(.timestamp) \(.filename) (\(.size) bytes)"'

Workflow Example

Share file with retry:

#!/bin/bash
DEST="1:0001.AAAA.BBBB"
FILE="/path/to/large-file.zip"
MAX_RETRIES=3

for RETRY in $(seq 1 $MAX_RETRIES); do
  echo "Attempt $RETRY/$MAX_RETRIES"

  if pilotctl --json send-file "$DEST" "$FILE" | jq -e '.success'; then
    echo "Transfer successful!"
    break
  fi

  [ $RETRY -lt $MAX_RETRIES ] && sleep 5
done

Dependencies

Requires pilot-protocol skill, pilotctl, jq, and tar.