# Mesh Network

Multi-machine agent distribution with secure peer-to-peer communication

SkillKit's mesh network enables secure communication between AI agents across multiple machines. Share skills, synchronize memory, and collaborate across your development environment.

## Quick Start

```
# Initialize mesh on your machine
npx skillkit mesh init

# Discover other hosts on your LAN
npx skillkit mesh discover

# Add a specific host
npx skillkit mesh add 192.168.1.100
```

## Security

The mesh network uses enterprise-grade security:

- **Ed25519** \- Peer identity and message signing
- **XChaCha20-Poly1305** \- End-to-end message encryption
- **TLS 1.3** \- Transport layer security
- **JWT with EdDSA** \- Authentication tokens

### Initialize Security

```
# Generate encryption keys
npx skillkit mesh security init

# Check security status
npx skillkit mesh security status
```

### Peer Trust Management

```
# Trust a peer by fingerprint
npx skillkit mesh peer trust abc123def456

# Revoke a peer's trust
npx skillkit mesh peer revoke abc123def456

# List trusted peers
npx skillkit mesh peer list
```

## Commands Reference

| Command                     | Description                          |
| --------------------------- | ------------------------------------ |
| `mesh init`                | Initialize mesh network              |
| `mesh add <address>`       | Add a host to mesh                   |
| `mesh remove <id>`         | Remove a host                        |
| `mesh list`                | List known hosts                     |
| `mesh discover`            | Discover hosts on LAN                |
| `mesh health`              | Check host health                    |
| `mesh status`              | Show mesh status                     |
| `mesh security init`       | Setup encryption keys                |
| `mesh security status`     | Show security status                 |
| `mesh peer trust <id>`     | Trust a peer                         |
| `mesh peer revoke <id>`    | Revoke peer trust                    |
| `mesh peer list`           | List trusted peers                   |

## Security Levels

| Level         | Discovery      | Transport | Auth   | Use Case        |
| --------------| -------------- | --------- | ------ | ---------------- |
| `development` | open           | none      | none   | Local dev       |
| `signed`      | signed         | optional  | optional | Trusted LAN     |
| `secure` (default) | signed   | required  | required | Production    |
| `strict`      | trusted-only   | required  | mTLS   | High security   |

## Architecture

The mesh network uses:

1. **UDP Multicast** \- LAN discovery with signed announcements
2. **WebSocket (WSS)** \- Real-time bidirectional communication
3. **HTTPS** \- RESTful API for management

All messages are signed and optionally encrypted based on your security level.

## Programmatic API

```
import { MeshHost, PeerIdentity } from '@skillkit/mesh';

// Generate identity
const identity = await PeerIdentity.generate();

// Create mesh host
const host = new MeshHost({
  hostId: 'my-workstation',
  identity,
  security: { mode: 'secure' },
});

await host.start();

// Send message to peer
await host.send('peer-fingerprint', {
  type: 'skill-sync',
  payload: { skills: ['react-patterns'] },
});
```

## Next Steps

- [Inter-Agent Messaging](/content/docs/messaging/index.html) \- Send messages between agents
- [Memory System](/content/docs/memory/index.html) \- Share learnings across the mesh