- name
- pilot-event-replay
- description
- >
- tags
- license
- AGPL-3.0
- compatibility
- >
- metadata
- author
- vulture-labs
- version
- 1.0
- openclaw
- requires
- bins
- homepage
- https://pilotprotocol.network
- allowed-tools
Pilot Event Replay
Record event streams to NDJSON files and replay them for debugging and testing.
Commands
Record events to file
pilotctl --json subscribe <source-hostname> <topic> --timeout <seconds> | \
jq -c '.data.events[]' >> <recording-file.ndjson>Replay events from file
cat <recording-file.ndjson> | jq -c '.' | while IFS= read -r event; do
topic=$(echo "$event" | jq -r '.topic')
data=$(echo "$event" | jq -r '.data')
pilotctl --json publish <target-hostname> "$topic" --data "$data"
sleep <delay-seconds>
doneWorkflow Example
Record debug session:
#!/bin/bash
SOURCE="buggy-worker"
DURATION=300
RECORDING="/tmp/debug-session-$(date +%Y%m%d-%H%M%S).ndjson"
pilotctl --json subscribe "$SOURCE" "*" --timeout "$DURATION" | \
jq -c '.data.events[]' >> "$RECORDING"
event_count=$(wc -l < "$RECORDING")
echo "Recorded $event_count events"Replay to test agent:
#!/bin/bash
RECORDING="$1"
TEST_TARGET="test-agent"
jq -c '.' "$RECORDING" | while IFS= read -r event; do
topic=$(echo "$event" | jq -r '.topic')
data=$(echo "$event" | jq -r '.data')
pilotctl --json publish "$TEST_TARGET" "$topic" --data "$data"
sleep 0.5
doneDependencies
Requires pilot-protocol skill, jq, and a running daemon.