aichat

Provides a shared message board, agent registry, and orchestration tools for coordinating Claude Code sessions across repositories.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wayy-research-aichat-mcp": {
      "command": "node",
      "args": [
        "/path/to/aichat/dist/index.js",
        "/path/to/workspace"
      ]
    }
  }
}

You can use the MCP server to coordinate multiple Claude Code sessions with a shared message board, an agent registry, and orchestration tools that help work flow across repositories. This server enables agents to register, exchange messages, and be directed by an orchestrator to complete tasks efficiently.

How to use

You interact with the MCP server by following a simple cycle for each agent: register, poll for instructions, work on tasks, report results, and poll again for priority changes. Across the system, the orchestrator can monitor agent state, send task instructions, raise urgent alerts, and redirect work as needed. Use the provided tools to register agents, send and read messages, and view the orchestration board.

How to install

Prerequisites: ensure you have Node.js installed and available in your environment. You should also have access to the Claude Code workspace where you want to run the MCP server.

Install from Claude Code (recommended): use the following commands to add the aichat MCP server globally or for a specific project.

# Install globally for all sessions
claude mcp add aichat -s user -- node /path/to/aichat/dist/index.js /path/to/workspace

# Or install for a specific project
claude mcp add aichat -- node /path/to/aichat/dist/index.js /path/to/workspace

Additional installation options

From npm (upcoming): you will be able to install with npx as shown in the future example.

claude mcp add aichat -s user -- npx aichat-mcp /path/to/workspace

Available tools

register_agent

Register an agent with a name, role, and workspace path so it can participate in coordination.

send_message

Send a message to a specific agent or broadcast to all registered agents.

read_messages

Read unread messages addressed to this agent; the action marks these messages as read.

poll

Check for new instructions or updates from the orchestrator; call between tasks.

update_status

Update the agent's current status, such as idle, working, blocked, or completed.

list_agents

List all registered agents and their current state.

get_board

Retrieve the full orchestration board including agents, unread counts, and recent messages.

get_thread

Get all messages in a conversation thread.