amq-cli

Automate inter-agent messaging with AMQ CLI routing, threads, and delivery receipts.

81|9|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/avivsinai/agent-message-queue --skill amq-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: amq-cli
Source: https://github.com/avivsinai/agent-message-queue/tree/main/skills/amq-cli
Command: npx skills add https://github.com/avivsinai/agent-message-queue --skill amq-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill coordinates inter-agent messaging across sessions and projects using the AMQ CLI, enabling reliable routing, threading, and delivery visibility for multi-agent coordination.

Core Features & Use Cases

  • File-based messaging with per-message frontmatter, threading, and delivery receipts.
  • Cross-session and cross-project routing, swarm integration, and basic orchestrator adapters.
  • Safe defaults and environment-aware operation (AM_ROOT, AM_ME, AMQ_GLOBAL_ROOT) for local development.

Quick Start

Open a terminal and run amq coop init to bootstrap a local inbox, then start messaging between agents using amq send.

Frequently Asked Questions about amq-cli

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

FAQPage Schema
How do I coordinate inter-agent messaging across different sessions?

Inter-agent messaging across sessions is coordinated using a CLI to route messages, manage threads, and handle delivery receipts for cross-project swarm operations. It applies file-based routing with per-message frontmatter to exchange status and decisions.

How does file-based message routing work for multi-agent swarms?

File-based message routing for swarms works by utilizing a CLI to send messages with frontmatter, enabling threading and delivery visibility. Agents exchange requests and decisions safely through local inboxes and environment-aware roots.

Do I need to install the amq binary before setting up agent messaging?

Yes, you need the amq binary in your PATH to use this agent messaging coordination skill. You must also bootstrap a local inbox using the CLI and ensure session layouts are configured under the .agent-mail directory.

What is the best way to start cross-project routing for AI agents?

The best way to start cross-project routing is to bootstrap a local inbox using the init command in your terminal. Once initialized, agents can send messages to each other to handle status updates and swarm coordination.

What environments are supported for local agent messaging development?

Local agent messaging development supports safe, environment-aware operation using variables like AM_ROOT, AM_ME, and AMQ_GLOBAL_ROOT. These environment configurations ensure safe defaults and proper routing for local development.

Why are delivery receipts important in inter-agent communication?

Delivery receipts in inter-agent communication provide visibility into message status across cross-session and cross-project threads. They ensure reliable routing and help operators confirm that agents successfully exchanged requests and decisions.