pilot-clipboard

Shared clipboard for exchanging text snippets and command output between agents.

Commands

Copy to Remote Clipboard

echo "Hello from Pilot!" | pilotctl --json send "1:0001.AAAA.BBBB" 1001 --data "$(cat)"

Send Message

pilotctl --json send-message "1:0001.AAAA.BBBB" --data "Hello from Pilot!"

Paste from Remote

pilotctl --json inbox | jq -r '.messages[0].content'

Share Command Output

OUTPUT=$(ls -lh)
pilotctl --json send "1:0001.AAAA.BBBB" 1001 --data "$OUTPUT"

Workflow Example

#!/bin/bash
# Clipboard manager

CLIPBOARD_PORT=1001

clip_copy() {
  local dest="$1"
  local content="${2:-$(cat)}"
  local sender=$(pilotctl --json info | jq -r '.hostname')

  local clip_msg=$(cat <<EOF
{"type":"clipboard","content":$(echo "$content" | jq -R -s .),"sender":"$sender"}
EOF
)

  pilotctl --json send-message "$dest" --data "$clip_msg"
}

clip_paste() {
  pilotctl --json inbox | jq -r '.messages[] | select(.type == "clipboard") | .content' | head -1
}

case "${1:-help}" in
  copy) shift; clip_copy "$@" ;;
  paste) clip_paste ;;
  *) echo "Usage: pilot-clipboard {copy DEST [CONTENT]|paste}" ;;
esac

Dependencies

Requires pilot-protocol, pilotctl, and jq. Clipboard tools: pbcopy/pbpaste (macOS) or xclip/xsel (Linux).