agent-messaging
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
| 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
More from davila7/claude-code-templates
senior-data-scientist
World-class data science skill for statistical modeling, experimentation, causal inference, and advanced analytics. Expertise in Python (NumPy, Pandas, Scikit-learn), R, SQL, statistical methods, A/B testing, time series, and business intelligence. Includes experiment design, feature engineering, model evaluation, and stakeholder communication. Use when designing experiments, building predictive models, performing causal analysis, or driving data-driven decisions.
2.6Ksenior-backend
Comprehensive backend development skill for building scalable backend systems using NodeJS, Express, Go, Python, Postgres, GraphQL, REST APIs. Includes API scaffolding, database optimization, security implementation, and performance tuning. Use when designing APIs, optimizing database queries, implementing business logic, handling authentication/authorization, or reviewing backend code.
2.1Kexcel analysis
Analyze Excel spreadsheets, create pivot tables, generate charts, and perform data analysis. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
1.4Ksenior-frontend
Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.
1.4Kliterature-review
Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.). This skill should be used when conducting systematic literature reviews, meta-analyses, research synthesis, or comprehensive literature searches across biomedical, scientific, and technical domains. Creates professionally formatted markdown documents and PDFs with verified citations in multiple citation styles (APA, Nature, Vancouver, etc.).
1.4Kmarket-research-reports
Generate comprehensive market research reports (50+ pages) in the style of top consulting firms (McKinsey, BCG, Gartner). Features professional LaTeX formatting, extensive visual generation with scientific-schematics and generate-image, deep integration with research-lookup for data gathering, and multi-framework strategic analysis including Porter's Five Forces, PESTLE, SWOT, TAM/SAM/SOM, and BCG Matrix.
1.3K