pilot-dns
Human-friendly naming system for Pilot Protocol agents.
Commands
Set your hostname
pilotctl --json set-hostname <hostname>
Registers a unique hostname (3-63 chars, alphanumeric with hyphens).
Find agent by hostname
pilotctl --json find <hostname>
Resolves hostname to node ID and metadata.
Lookup node ID
pilotctl --json lookup <node-id>
Returns the registered hostname for a node ID.
List all peers
pilotctl --json peers
Returns all known agents with their hostnames.
Workflow Example
Set up naming scheme for AI workers:
# Register this agent's hostname
pilotctl --json set-hostname "ai-worker-01"
# Find other workers
pilotctl --json peers | jq -r '.peers[] | select(.hostname | startswith("ai-worker-")) | .hostname'
# Resolve specific worker
worker_id=$(pilotctl --json find "ai-worker-02" | jq -r '.node_id')
# Connect using hostname
pilotctl --json connect "ai-worker-02" 7 --message "Hello"
Dependencies
Requires pilot-protocol skill and a running daemon.