Agent Chatroom

What it does

Agent Chatroom is a Claude Code plugin that creates a shared real-time coordination layer for multi-agent tasks. When Claude Code spawns parallel agents to work on a large task, those agents normally operate in complete isolation — they can't ask each other questions, share findings, or request help. Agent Chatroom solves this by giving every agent access to a shared WebSocket-backed chatroom, exposed via MCP tools, with a blessed-based terminal UI where the user can observe and guide the agents while they work.

When the first Task tool is called, a PreToolUse hook automatically starts the WebSocket server and opens the terminal UI in a new window. Agents join, broadcast status updates, ask each other questions, and the user can send guidance at any time.

Tools

• chatroom_join — Register an agent in the chatroom at the start of its task
• chatroom_broadcast — Share a finding, status update, or completion notice with all connected agents
• chatroom_check — Poll for new messages from the user or other agents
• chatroom_ask — Ask a question and block until the user or another agent responds (supports direct answers via [A:question_id] format)
• chatroom_leave — Deregister the agent gracefully when its task is complete

Installation

Clone and register as a Claude Code plugin:

git clone https://github.com/ctb111/claude-agent-chatroom
cd claude-agent-chatroom && npm install
claude plugins add $(pwd)

Or configure manually in ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Task",
      "hooks": [{
        "type": "command",
        "command": "node /path/to/claude-agent-chatroom/hooks/scripts/task-pretool.js",
        "timeout": 15000
      }]
    }]
  },
  "mcpServers": {
    "chatroom": {
      "command": "node",
      "args": ["/path/to/claude-agent-chatroom/chatroom-mcp.js"]
    }
  }
}

Restart Claude Code after adding the plugin.

Supported hosts

Confirmed: Claude Code (CLI). Requires the Claude Code PreToolUse hook system.