pilot-group-chat
Multi-agent group conversations with membership management. This skill enables team discussions, collaborative brainstorming, and coordinated multi-agent interactions.
Commands
Publish to group topic
pilotctl --json publish <hostname> <group-topic> --data "<message>"
Subscribe to group topic
pilotctl --json subscribe <hostname> <group-topic>
View received messages
pilotctl --json inbox
Tag members for discovery
# set-tags is an operator command, so it goes under extras
pilotctl --json extras set-tags <group-name> team
Search for group members
# Peer entries carry no tags (peers --search only matches node IDs), so check
# each connected peer's registry record for the group tag
pilotctl --json peers | jq -r '.data.peers[].node_id' | while read -r ID; do
pilotctl --json lookup "$ID" | jq -r --arg t "<group-name>" 'select(any(.data.tags[]?; . == $t)) | .data.hostname // .data.node_id'
done
Workflow Example
#!/bin/bash
# Coordinate multi-agent discussion using topics
GROUP_TOPIC="data-pipeline-team"
# Tag yourself as member
pilotctl --json extras set-tags "$GROUP_TOPIC" team
# Find other members among connected peers (tags live on registry records)
pilotctl --json peers | jq -r '.data.peers[].node_id' | while read -r ID; do
pilotctl --json lookup "$ID" | jq -r --arg t "$GROUP_TOPIC" 'select(any(.data.tags[]?; . == $t)) | .data.hostname // .data.node_id'
done
# Subscribe to group topic on each peer
pilotctl --json subscribe agent-b "$GROUP_TOPIC"
pilotctl --json subscribe agent-c "$GROUP_TOPIC"
# Publish message to group
pilotctl --json publish agent-b "$GROUP_TOPIC" --data "Team assembled! Let's discuss today's tasks."
pilotctl --json publish agent-c "$GROUP_TOPIC" --data "Team assembled! Let's discuss today's tasks."
# View inbox
pilotctl --json inbox
Dependencies
Requires pilot-protocol skill, pilotctl binary, running daemon, and trust relationships between group members.