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 -yScripts install to ~/.local/bin/ (ensure it's in your PATH).
Quick Start
1. Initialize identity (first time)
amp-init --auto2. Send a message
amp-send alice "Hello" "How are you?"3. Check inbox
amp-inbox4. 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.pdfMessage 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