using-agent-relay

Automate inter-agent messaging for real-time coordination and task handoffs.

790|60|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/khaliqgant/agent-relay --skill using-agent-relay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-agent-relay
Source: https://github.com/khaliqgant/agent-relay/tree/main/.claude/skills/using-agent-relay/SKILL.md
Command: npx skills add https://github.com/khaliqgant/agent-relay --skill using-agent-relay

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill documents how to coordinate multiple AI agents using agent-relay for real-time messaging (tmux wrapper) and file-based async workflows.

Core Features & Use Cases

  • Real-time inter-agent messaging via tmux wrapper
  • Async, file-based team inbox for coordination
  • Patterns for direct messages, broadcasts, and multi-project bridging
  • Use Case: Two agents collaborate on a code review with live messaging.

Quick Start

Start the relay daemon, wrap an agent named Alice, and use relay commands to send messages.

Frequently Asked Questions about using-agent-relay

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

FAQPage Schema
How do I set up real-time messaging between multiple AI agents?

Real-time inter-agent messaging uses a tmux-based relay daemon to coordinate agent communication. Start the relay daemon, wrap each agent with relay commands, and send structured messages through tmux channels. This enables sub-5ms latency coordination for multi-agent teams working on shared codebases.

Can I coordinate agents asynchronously without real-time tmux channels?

Yes. Agent-relay supports file-based asynchronous inboxes alongside real-time messaging. Teams can use structured message patterns written to shared files, enabling coordination across agents that operate on different schedules or in environments where tmux isn't available.

What communication patterns does agent-relay support for team coordination?

Agent-relay provides direct messages between agents, broadcast messages to multiple agents, and multi-project bridging patterns. These structured message formats enable task handoffs, parallel work distribution, and collaboration workflows across Claude, Codex, and Gemini agent ecosystems.

How do I start, stop, and monitor agent-relay messaging?

CLI controls manage the relay lifecycle: start the daemon to begin coordination, use relay commands to send and receive messages through tmux or file-based channels, and stop the daemon when coordination is complete. Reading messages retrieves task updates from the team inbox.

Does agent-relay work with existing tmux workflows in shared codebases?

Yes. Agent-relay wraps tmux to automate inter-agent messaging while integrating with existing terminal sessions. It's designed for teams already using tmux in shared codebase environments and adds agent coordination without replacing your current workflow.

What's the latency performance for agent relay messaging?

Agent-relay satisfies sub-5ms latency requirements for tmux-based channels, making it suitable for real-time coordination scenarios. File-based asynchronous inboxes trade latency for reliability in distributed setups.