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
- Initialize identity (first time)
amp-init --auto
- Send a message
amp-send alice "Hello" "How are you?"
- Check inbox
amp-inbox
- Read a message
amp-read <message-id>
- 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