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.