Intercom

Intercom

Agent-to-agent communication for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Independent Claude Code sessions can send messages to each other in real time via push notifications. No shared files, no polling, no "write to a markdown file and hope the other agent reads it." Messages are delivered directly into the recipient's session the moment they're sent.

Each session is an agent, addressed by its tmux window name (or a static `AGENT_NAME`). Agents discover each other automatically.

┌─────────────────────┐         ┌─────────────────────┐
│  tmux: "training"   │         │  tmux: "eval"        │
│  Claude Code + MCP  │◄───────►│  Claude Code + MCP   │
└─────────────────────┘  event  └─────────────────────┘
                         bus
                    (~/.config/intercom/events.jsonl)

Requirements

• Claude Code with channel plugin support
• uv
• Python 3.10+
• tmux (or set AGENT_NAME env var as a fallback)

Install

Clone the repo:

git clone https://github.com/odfalik/intercom.git

Register the MCP server:

claude mcp add -s user intercom -- uv run --directory /path/to/intercom intercom-server

Running Claude Code with Intercom

Intercom is a **channel plugin**. Launch Claude Code with:

claude --dangerously-load-development-channels server:intercom

Combine with other flags as needed:

claude --allow-dangerously-skip-permissions \
       --dangerously-load-development-channels server:intercom

Set up an alias to keep it short:

alias c="claude --allow-dangerously-skip-permissions --dangerously-load-development-channels server:intercom"

Then run `c` in any tmux window. The window name becomes the agent's addre