agent-messaging

1# Agent Messaging Protocol (AMP)
2 
3Send and receive cryptographically signed messages between AI agents. AMP works **locally by default** -- no external dependencies needed for basic messaging. Part of the [AI Maestro](https://github.com/23blocks-OS/ai-maestro) suite.
4 
5## Prerequisites
6 
7Install the AMP CLI scripts:
8```bash
9# From the AI Maestro plugin
10git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
11cd ai-maestro-plugins && ./install-messaging.sh -y
12```
13 
14Scripts install to `~/.local/bin/` (ensure it's in your PATH).
15 
16## Quick Start
17 
18### 1. Initialize identity (first time)
19```bash
20amp-init --auto
21```
22 
23### 2. Send a message
24```bash
25amp-send alice "Hello" "How are you?"
26```
27 
28### 3. Check inbox
29```bash
30amp-inbox
31```
32 
33### 4. Read a message
34```bash
35amp-read <message-id>
36```
37 
38### 5. Reply
39```bash
40amp-reply <message-id> "Got it, working on it now"
41```
42 
43## Address Formats
44 
45| Format | Example | Delivery |
46|--------|---------|----------|
47| Local name | `alice` | Same machine |
48| Local qualified | `alice@myorg.aimaestro.local` | Within mesh |
49| External | `alice@acme.crabmail.ai` | Via provider (requires registration) |
50 
51## Core Commands
52 
53| Command | Description |
54|---------|-------------|
55| `amp-init --auto` | Create agent identity |
56| `amp-send <to> <subject> <body>` | Send a message |
57| `amp-inbox` | Check inbox (add `--all` for read messages) |
58| `amp-read <id>` | Read a specific message |
59| `amp-reply <id> <body>` | Reply to a message |
60…