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

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

# 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