Claude-code-templates agent-messaging
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.
git clone https://github.com/davila7/claude-code-templates
T=$(mktemp -d) && git clone --depth=1 https://github.com/davila7/claude-code-templates "$T" && mkdir -p ~/.claude/skills && cp -r "$T/cli-tool/components/skills/ai-maestro/agent-messaging" ~/.claude/skills/davila7-claude-code-templates-agent-messaging && rm -rf "$T"
cli-tool/components/skills/ai-maestro/agent-messaging/SKILL.mdAgent 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 | | Same machine |
| Local qualified | | Within mesh |
| External | | Via provider (requires registration) |
Core Commands
| Command | Description |
|---|---|
| Create agent identity |
| Send a message |
| Check inbox (add for read messages) |
| Read a specific message |
| Reply to a message |
| Delete a message |
| Show identity and registrations |
| 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 | |
|---|---|---|---|---|
| General info (default) | | Standard (default) | |
| Asking for something | | Immediate attention | |
| Assigned work | | Respond soon | |
| Transferring context | | When convenient | |
| 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