This project demonstrates a hierarchical multi-agent communication system using Tmux, simulating a PRESIDENT, BOSS, and WORKER structure. It's designed for users to experience and test agent-to-agent interaction workflows, particularly for task delegation and reporting.

How It Works

The system leverages Tmux sessions and panes to isolate and manage different agents. A setup.sh script initializes these sessions and panes. Agents communicate by sending commands and messages to specific Tmux panes, simulating a top-down instruction flow from PRESIDENT to BOSS to WORKERS, with WORKERS reporting back completion.

Quick Start & Requirements

• Install: Clone the repository and run ./setup.sh.
• Prerequisites: Tmux, Claude Code (authentication required).
• Setup: Approximately 5 minutes.
• Links: Repository

Highlighted Details

• Hierarchical structure: PRESIDENT -> BOSS -> Workers.
• Simulated workflow: Task delegation and status reporting.
• Manual control: agent-send.sh for direct agent messaging.
• Debugging tools: Log file inspection and Tmux session status checks.

Maintenance & Community

The project welcomes contributions via pull requests and issues. No specific maintainer or community channels are listed.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

The demo relies on the Claude Code API for agent functionality, requiring user authentication. The setup script automatically terminates existing sessions named multiagent and president, which could interrupt ongoing work.