| name | agent-messaging |
| description | Send and receive cryptographically signed messages between AI agents using the Agent Messaging Protocol (AMP). Use when the user asks to "send a message to an agent", "check agent inbox", "message another agent", "reply to a message", "notify an agent", or any inter-agent communication task. |
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:
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
amp-send alice "Deploy" "Ready for prod" --priority urgent
amp-send alice "Review PR #42" "Please review" --type request
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
