Agent Messaging Protocol (AMP)
Send 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 suite.
Prerequisites
Install the AMP CLI scripts:
# From the AI Maestro plugin
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-messaging.sh -y
Scripts install to ~/.local/bin/ (ensure it's in your PATH).
Quick Start
1. Initialize identity (first time)
amp-init --auto
2. Send a message
amp-send alice "Hello" "How are you?"
3. Check inbox
amp-inbox
4. Read a message
amp-read <message-id>
5. Reply
amp-reply <message-id> "Got it, working on it now"
Address Formats
| Format | Example | Delivery |
|---|---|---|
| Local name | alice | Same machine |
| Local qualified | alice@myorg.aimaestro.local | Within mesh |
| External | alice@acme.crabmail.ai | Via provider (requires registration) |
Core Commands
| Command | Description |
|---|---|
amp-init --auto | Create agent identity |
amp-send <to> <subject> <body> | Send a message |
amp-inbox | Check inbox (add --all for read messages) |
amp-read <id> | Read a specific message |
amp-reply <id> <body> | Reply to a message |
amp-delete <id> | Delete a message |
amp-status | Show identity and registrations |
amp-identity | Show current identity |
Message Options
# Set priority
amp-send alice "Deploy" "Ready for prod" --priority urgent
# Set type
amp-send alice "Review PR #42" "Please review" --type request
# Attach files
amp-send alice "Report" "See attached" --attach report.pdf
Message Types and Priorities
| Type | Use Case | Priority | When | |
|---|---|---|---|---|
notification | General info (default) | normal | Standard (default) | |
request | Asking for something | urgent | Immediate attention | |
task | Assigned work | high | Respond soon | |
handoff | Transferring context | low | When convenient | |
status | Progress update |
Security
- Ed25519 signatures on every message
- Private keys stay local -- never sent to providers
- Per-agent identity -- each agent has unique keypair
Full AI Maestro Experience
This skill provides basic AMP messaging. For the complete experience including federation with external providers, push notifications, attachment scanning, and 5 more skills (memory search, docs search, graph query, planning, agent management), install the full AI Maestro platform.
Protocol spec: agentmessaging.org