claude-intercom

Real-time messaging between Claude Code instances. When one agent sends a message, the others get it instantly — no polling, no manual checks.

Built as an MCP server + filesystem watcher that wakes idle agents automatically via asyncRewake.

Terminal 1                          Terminal 2
┌─────────────────────┐            ┌─────────────────────┐
│ claude (agent sgup)  │            │ claude (agent 4jov)  │
│                      │            │                      │
│ > send("4jov",       │ ──JSON──▶ │ 📬 sgup: tu touches  │
│   "tu touches        │   file    │    auth.ts ?          │
│    auth.ts ?")       │            │                      │
│                      │ ◀──JSON── │ > reply("Non,        │
│ 📬 4jov: Non,        │   file    │   je suis sur        │
│   je suis sur billing│            │   billing")          │
└─────────────────────┘            └─────────────────────┘

• Each instance gets a unique 4-char code (e.g. x7k2) on startup
• Messages are JSON files in a shared store/ directory
• A fs.watch watcher detects new files instantly and wakes the receiving agent
• Dead agents are auto-cleaned via PID checking

# Clone
git clone https://github.com/sanztheo/claude-intercom.git ~/.claude/mcp-intercom

# Install deps
cd ~/.claude/mcp-intercom && bun install

Add to ~/.mcp.json:

{
  "mcpServers": {
    "intercom": {
      "type": "stdio",
      "command": "bun",
      "args": ["~/.claude/mcp-intercom/src/server.ts"]
    }
  }
}

Add to ~/.claude/settings.json under "hooks":

{
  "hooks": {
    "PreToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bun ~/.claude/mcp-intercom/src/hook.ts",
            "timeout": 3000
          }
        ]
      }
    ],
    "Stop": [
      {
        "