About agent-messaging
agent-messaging is a skill for sending and receiving cryptographically signed messages between AI agents, with local messaging available by default. It provides AMP commands for identity, inboxes, replies, message types, priorities and attachments.
Key features
- 01Create per-agent identities
- 02Send and receive signed messages
- 03Manage inboxes and replies
- 04Set message types and priorities
- 05Attach files to messages
Use cases
- 01Coordinate agents on one machine
- 02Send task or status updates
- 03Assign work or hand off context
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/agent-messagingin Claude Code to confirm it loaded.
Details
From the project READMEAgent 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 | [email protected] | Within mesh |
| External | [email protected] | 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