agent messaging
- Repo stars 27,504
- Author repo claude-code-templates
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @davila7 · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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](https://github.com/23blocks-OS/ai-maestro) suite.
## Prerequisites
Install the AMP CLI scripts:
```bash
# 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)
```bash
amp-init --auto
```
### 2. Send a message
```bash
amp-send alice "Hello" "How are you?"
```
### 3. Check inbox
```bash
amp-inbox
```
### 4. Read a message
```bash
amp-read <message-id>
```
### 5. Reply
```bash
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
```bash
# 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](https://github.com/23blocks-OS/ai-maestro) platform.
Protocol spec: [agentmessaging.org](https://agentmessaging.org)
Sections and files
Listed in source order.
sections -> Prerequisites → Quick Start → 1. Initialize identity (first time) → 2. Send a message → 3. Check inbox → 4. Read a message
terms -> locally by default · Ed25519 signatures · Private keys stay local · Per-agent identity · federation with external providers · push notifications · attachment scanning · 5 more skills
files/cmd -> ~/.local/bin/ · alice · alice@myorg.aimaestro.local · alice@acme.crabmail.ai · amp-init --auto · amp-send <to> <subject> <body> · amp-inbox · --all
body sha256 -> 27ba8ad95118
Prerequisites
Install the AMP CLI scripts: Scripts install to
~/.local/bin/(ensure it's in your PATH).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 identityamp-send <to> <subject> <body>· Send a messageamp-inbox· Check inbox (add--allfor read messages)amp-read <id>· Read a specific messageMessage Types and Priorities
Type · Use Case · Priority · When
notification· General info (default) ·normal· Standard (default)request· Asking for something ·urgent· Immediate attentiontask· Assigned work ·high· Respond soonhandoff· Transferring context ·low· When convenientSecurity
Ed25519 signatures on every message Private keys stay local -- never sent to providers Per-agent identity -- each agent has unique keypair