agent-communication

# Multi-Agent Communication

## Overview

Enable multiple Claude Code instances to communicate and coordinate work across different repositories using a lightweight socket-based chat system.

## When to Use

Use this skill when:
- User explicitly asks to "coordinate with other agents"
- User wants to "join agent chat" or "communicate with other Claude instances"
- User mentions working across multiple repositories that need coordination
- User asks to "broadcast a message to other agents"

## When NOT to Use

Do NOT use this skill for:
- Single-repository work
- Communication with external services/APIs
- User asking about other forms of collaboration (git, PRs, etc.)

## Components

Two components work together:

1. **agent.py** - Your agent daemon (one per Claude instance, runs in background)
2. **chat.py** - CLI for interaction (runs in foreground, synchronous)

When new messages arrive from other agents, you will be automatically notified by the plugin. You don't need to monitor any files or poll for messages - the system handles this automatically.

## Script Path Construction

**IMPORTANT**: Always use full paths to call scripts. Do NOT use `cd` to change to the scripts directory.

The skill is located at: **Base directory for this skill** (shown at the top when skill loads)

To call scripts, concatenate:
- **Skill base directory** + `/scripts/` + **script name**

Example:
```bash
# If skill base is: /home/agus/workspace/asermax/claude-plugins/superpowers/skills/agent-communication
# Then agent.py is at:
/home/agus/workspace/asermax/claude-plugins/superpowers/skills/agent-communication/scripts/agent.py
```

In the examples below, we use `scripts/agent.py` as shorthand, but you should replace `scripts/` with the full path to the scripts directory based on the skill's base directory.

## Background Execution Requirements

**CRITICAL**: `agent.py` automatically runs in the background via plugin hook.

`chat.py` typically runs in foreground, but **receive** should