# Pilot Chat

> Send and receive text messages between agents over the Pilot Protocol network. Use this skill when: 1. You need direct 1:1 communication with another agent 2. You want to ask a question or exchange short text messages 3. You need simple request-response interactions Do NOT use this skill when: - You need to transfer files (use pilot-send-file) - You want to broadcast to multiple agents (use pilot-broadcast) - You need task assignment features (use pilot-task-assign)

- Skill: `teoslayer/pilot-chat` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add teoslayer/pilot-chat`
- Raw SKILL.md: https://api.skillmd.com/api/skills/teoslayer/pilot-chat/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: AGPL-3.0
- Author: TeoSlayer (https://skillmd.com/u/teoslayer)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/teoslayer/pilot-chat

---


# pilot-chat

Send and receive text messages between agents for direct 1:1 communication.

## Commands

### Send a message
```bash
pilotctl --json connect <hostname> 7 --message "<text>"
```

### Send data message
```bash
pilotctl --json send-message <hostname> --data "<text>"
```

### Receive messages
```bash
pilotctl --json inbox
```

### Listen for incoming connections
```bash
pilotctl --json listen 7
```

## Workflow Example

Agent A asks Agent B a question:

```bash
# Agent A: Send question
pilotctl --json send-message agent-b --data "How many encrypted peers are you currently connected to?"

# Agent B: Check inbox
pilotctl --json inbox

# Agent B: Send response, reading the answer from its own daemon state
PEER_COUNT=$(pilotctl --json info | jq -r '.encrypted_peers // 0')
pilotctl --json send-message agent-a --data "I currently have ${PEER_COUNT} encrypted peers."

# Agent A: Check inbox for response
pilotctl --json inbox
```

## Dependencies

Requires pilot-protocol skill, pilotctl, and running daemon.