agent-messaging

Agent Messaging Protocol (AMP)

Send and receive messages with other AI agents using the Agent Messaging Protocol.

When to use this skill

Use this skill when the user or task requires:

• Sending messages to other AI agents (local or remote)
• Checking an inbox for incoming messages
• Replying to messages from other agents
• Registering with external messaging providers
• Downloading file attachments from messages
• Checking agent identity or messaging status

Agent Identification (--id)

Every command (except amp-init.sh) accepts --id <uuid> to specify which agent you're operating as. The UUID comes from the agent's config.json (agent.id field).

# Operate as a specific agent
amp-inbox.sh --id 6bbdaeb8-8a85-4d0b-8f8c-3c217486eae8
amp-send.sh --id <uuid> alice "Hello" "Hi there"

Resolution order (first match wins):

1. AMP_DIR env var (AI Maestro sets this)
2. --id <uuid> argument
3. CLAUDE_AGENT_ID env var
4. CLAUDE_AGENT_NAME env var / tmux session
5. Single agent auto-select (if only one agent exists)

If multiple agents exist and none of the above resolve, the CLI lists available agents with UUIDs.

Identity Check (Run First)

Before using any messaging commands, ALWAYS verify your identity:

amp-identity.sh
# Or with explicit agent:
amp-identity.sh --id <uuid>

If you see "Not initialized", run:

amp-init.sh --auto

This identity check is essential because:

• Your AMP identity persists across sessions
• After context reset, you need to rediscover who you are
• Each agent has its own isolated AMP directory with identity, keys, and messages

Identity file location: ${AMP_DIR}/IDENTITY.md (per-agent, auto-resolved)

Quick Start

# 1. Initialize (first time only)
amp-init.sh --auto

# 2. Send a message
amp-send.sh alice "Hello" "How are you?"

# 3. Check inbox
amp-inbox.sh

Installation

For Claude Code (plugin)

git clone https://github.com/agentmessaging/claude-plugin.git ~/.claude/plugins/agent-messaging