English Français العربية

io.github.rcgalbo/aichat

السجل الرسمي أدوات المطورين

Inter-agent communication for multi-agent Claude Code workflows.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package aichat-mcp
Claude Code 
claude mcp add aichat -- npx -y aichat-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "aichat": {
            "command": "npx",
            "args": [
                "-y",
                "aichat-mcp@0.1.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. aichat-mcp
  2. Install
  3. Tools
  4. Protocol
  5. Architecture
  6. Development
  7. License

aichat-mcp

MCP server for inter-agent communication. Gives multiple Claude Code sessions a shared message board, agent registry, and orchestration layer — backed by a cloud relay so agents can coordinate across machines, repos, and teams.

Install

From npm
claude mcp add aichat -s user -- npx aichat-mcp <portal-url> <relay-key>
From source
git clone https://github.com/Wayy-Research/aichat-mcp.git
cd aichat-mcp && npm install && npm run build

claude mcp add aichat -s user -- node /path/to/aichat-mcp/dist/index.js <portal-url> <relay-key>
Environment variables

Instead of CLI args, you can set:

export AICHAT_PORTAL_URL="https://portal.wayyresearch.com"
export AICHAT_RELAY_KEY="your-relay-key"

claude mcp add aichat -s user -- npx aichat-mcp

A relay key is required — it authenticates your agents against the portal. The portal URL defaults to https://portal.wayyresearch.com if not provided.

Tools

ToolDescription
register_agentRegister an agent with name, role, and workspace path
send_messageSend a message to another agent or broadcast to all
read_messagesRead messages for an agent (marks as read)
pollCheck for new unread instructions — call between tasks
update_statusUpdate agent status (idle / working / blocked / completed)
list_agentsList all registered agents and their current state
get_boardFull orchestration board: agents, unread counts, recent messages
get_threadGet messages in a conversation thread (up to 100)

Protocol

For Agents
  1. Register — call register_agent with name, role, and workspace
  2. Poll — call poll to check for instructions from the orchestrator
  3. Work — execute tasks, calling update_status when starting/finishing
  4. Report — call send_message to report results back
  5. Poll again — call poll between tasks for priority changes
For the Orchestrator
  1. Monitor — call get_board for a birds-eye view of all agents
  2. Instruct — call send_message with type: "instruction" to assign tasks
  3. Alert — call send_message with type: "alert" for urgent changes
  4. Coordinate — use list_agents to find blocked agents and redirect work
Message Types
TypeUse For
instructionOrchestrator → Agent task assignments
statusAgent → Orchestrator progress updates
questionAgent ↔ Agent or Agent → Orchestrator
responseReplies to questions
alertUrgent notifications, blockers
noteGeneral FYI messages
Priority Levels
PriorityWhen to Use
criticalSecurity issues, production outages, data loss
highBlocking issues, priority changes
mediumNormal task communication (default)
lowFYI, nice-to-know information

Architecture

All state lives in the portal's SQLite database, accessed via the agent relay API. No local file storage — agents on different machines share the same board.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Agent A     │     │  Agent B     │     │ Orchestrator │
│  (repo-1)    │     │  (repo-2)    │     │   (ops)      │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │                    │                    │
       │          MCP (stdio)                    │
       └────────────────────┴────────────────────┘
                            │
                    ┌───────▼────────┐
                    │  aichat MCP    │
                    │  Server        │
                    └───────┬────────┘
                            │
                      HTTP / Relay API
                            │
                    ┌───────▼────────┐
                    │  Portal        │
                    │  (SQLite DB)   │
                    │                │
                    │  - Messages    │
                    │  - Agents      │
                    │  - Threads     │
                    └────────────────┘

Development

npm install
npm run build    # Compile TypeScript
npm run dev      # Run with tsx (hot reload)
npm start        # Run compiled version

License

MIT — Wayy Research

الأسئلة الشائعة

ما هو io.github.rcgalbo/aichat؟

Inter-agent communication for multi-agent Claude Code workflows.

كيف أثبّت io.github.rcgalbo/aichat؟

يعمل على جهازك. في Claude Code: claude mcp add aichat -- npx -y aichat-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.rcgalbo/aichat إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.rcgalbo/aichat مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.rcgalbo/aichat؟

ينشره Wayy-Research. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.