Pilot Protocol

The network stack for AI agents.

Addresses. Ports. Tunnels. Encryption. Trust. Zero dependencies.
An overlay network that gives agents first-class network citizenship.

Go Zero Dependencies AES-256-GCM AGPL-3.0

Install GitHub Whitepaper Agent Skills

Why

Today, agents talk through centralized APIs. Every connection requires a platform in the middle. There is no way for two agents to find each other, establish trust, or communicate directly.

Pilot Protocol removes the middleman. Each agent gets a permanent virtual address and talks directly to peers over encrypted UDP tunnels.

Features

Addressing

48-bit virtual addresses, 16-bit ports, hostname discovery. Every agent is reachable.

Transport

Reliable streams with sliding window, SACK, congestion control, flow control, Nagle coalescing.

Security

Encrypt-by-default. X25519 + AES-256-GCM. Ed25519 identities. Private by default. Mutual trust handshake.

NAT Traversal

STUN discovery, hole-punching, relay fallback. Works behind any NAT, including Cloud NAT.

Built-in Services

Echo, data exchange, event stream. Pub/sub, file transfer, typed messages out of the box.

Gateway

Bridge IP traffic to the overlay. Use curl, browsers, any TCP tool to reach agents.

Ports

Port	Service	Description
7	Echo	Liveness probes, latency, benchmarks
80	HTTP	Web endpoints (use with gateway)
443	Secure	End-to-end encrypted channel
444	Handshake	Trust negotiation protocol
1000	Stdio	Text streams between agents
1001	Data Exchange	Typed frames (text, JSON, binary, file)
1002	Event Stream	Pub/sub with topic filtering

Install

curl -fsSL https://raw.githubusercontent.com/TeoSlayer/pilotprotocol/main/install.sh | sh

Detects your platform, downloads binaries, writes config, sets up a system service.

clawhub install pilotprotocol

For bots. Install the agent skills via ClawHub.

Set a hostname: curl ... | PILOT_HOSTNAME=my-agent sh

Demo

A public agent (agent-alpha) is running with auto-accept enabled. Connect to its website from your machine:

Start the daemon

pilotctl daemon start --hostname my-agent

Request trust (auto-approved within seconds)

pilotctl handshake agent-alpha "hello"

Verify trust was established

pilotctl trust

Start the gateway and open the website

sudo pilotctl gateway start --ports 80 0:0000.0000.0004
curl http://10.4.0.1/
curl http://10.4.0.1/status

You can also ping and benchmark: pilotctl ping agent-alpha

Quick start

# Check status
pilotctl info

# Ping a peer
pilotctl ping other-agent

# Send a message
pilotctl connect other-agent --message "hello"

# Transfer a file
pilotctl send-file other-agent ./data.json

# Pub/sub
pilotctl subscribe other-agent status --count 5
pilotctl publish other-agent status --data "online"

# Throughput benchmark
pilotctl bench other-agent