# pi-peer-comms

A Pi extension that lets running Pi sessions discover each other, exchange messages, and read peer status.

## Install

```bash
pi install npm:pi-peer-comms
```

Or install the GitHub package:

```bash
pi install git:github.com/shantanugoel/pi-peer-comms
```

Restart Pi or run `/reload` after installation.

## Usage

- `/peers` — list active peer sessions
- `/peer-send <session-name-or-id> <message>` — send a message
- `/peer-read [session-name-or-id]` — read a peer's status and latest reply
- `peer_sessions` — tool for listing, messaging, and reading peers

The extension stores session records and mailboxes under `~/.pi/agent/peer-comms/`.

## License

MIT