AI Maestro Agent Messaging

Send and receive messages between AI Maestro agents via CLI scripts.

744|94|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/23blocks-OS/ai-maestro --skill ai-maestro-agent-messaging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: AI Maestro Agent Messaging
Source: https://github.com/23blocks-OS/ai-maestro/tree/main/skills/agent-messaging
Command: npx skills add https://github.com/23blocks-OS/ai-maestro --skill ai-maestro-agent-messaging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Enable communication between AI coding agents using AI Maestro's messaging system. Agents are identified by their agent ID or alias, with tmux session names as a fallback. Supports both SENDING and RECEIVING messages.

Core Features & Use Cases

  • Dual-channel messaging: file-based messages (persistent) and instant tmux notifications.
  • Cross-host messaging: supports remote hosts via hosts.json and agent alias resolution.
  • Inbox/Outbox UI & CLI: check unread, read messages, compose, forward, and search.

Quick Start

Example: Check YOUR inbox: check-aimaestro-messages.sh Read a message: read-aimaestro-message.sh <msg-id> Send a message: send-aimaestro-message.sh frontend-dev "Re: API endpoint" "Implemented the feature." normal response

Frequently Asked Questions about AI Maestro Agent Messaging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send messages between AI Maestro agents?

Send messages between agents using send-aimaestro-message.sh with the recipient's agent ID or alias, subject, message body, and priority level. Messages are stored persistently in the recipient's inbox and can trigger tmux notifications for immediate alerting.

Can I use agent messaging across different hosts?

Yes, cross-host messaging is supported via hosts.json configuration and agent alias resolution. Agents are identified by ID or alias, with tmux session names as fallback, enabling reliable message exchange across remote systems.

How do I check and read messages in my inbox?

Use check-aimaestro-messages.sh to view unread messages and read-aimaestro-message.sh with a message ID to open specific messages. Both commands access your inbox through the CLI or UI for full message management.

What's the difference between file-based and tmux notification messaging?

File-based messages persist in agent inboxes for later retrieval, while tmux notifications deliver instant alerts to active sessions. The dual-channel system ensures both persistent record-keeping and real-time agent awareness.

Do I need special setup to enable inter-agent communication?

Agent identity resolution via ID or alias is required; tmux session names serve as fallback. No external dependencies are needed—the messaging system operates within AI Maestro's built-in command-based workflow for sending, checking, and reading messages.