This project enables ad-hoc, instant messaging between multiple Claude Code instances running on the same machine. It's designed for users managing several development sessions, allowing them to discover and communicate with each other seamlessly.

How It Works

A local broker daemon (defaulting to localhost:7899) manages a SQLite database to track registered Claude Code peers. Each Claude Code session runs an MCP server that registers with the broker and polls for messages every second. Inbound messages are pushed directly into the target Claude session via the claude/channel protocol for immediate delivery. An optional auto-summary feature, leveraging gpt-5.4-nano (requires OPENAI_API_KEY), generates context-aware descriptions of each instance's work, enhancing peer discovery.

Quick Start & Requirements

• Installation: Clone the repository and run bun install.
• MCP Server Registration: Register the claude-peers MCP server using claude mcp add --scope user --transport stdio claude-peers -- bun <path>/server.ts.
• Running Claude Code: Launch Claude Code with claude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-peers. An alias is recommended.
• Prerequisites: Bun, Claude Code v2.1.80+, claude.ai login (essential for channels). OPENAI_API_KEY is optional for auto-summary.
• Setup: Minimal, focused on dependency installation and launching Claude Code sessions.

Highlighted Details

• Peer Discovery & Messaging: Facilitates finding other Claude Code instances (list_peers) and sending instant messages (send_message) through the local broker.
• Auto-Summary: Generates brief, context-aware work summaries using gpt-5.4-nano (if OPENAI_API_KEY is set), visible to other peers.
• CLI Interaction: A bun cli.ts script allows command-line management of the broker, peer listing, and message sending.
• Automatic Broker Management: The broker auto-launches and cleans up dead peers automatically.

Maintenance & Community

No specific details on contributors, sponsorships, community channels, or roadmap are provided in the README.

Licensing & Compatibility

The README does not specify a license. Commercial use or closed-source linking compatibility is not detailed.

Limitations & Caveats

Requires claude.ai login for channel functionality; API key authentication is not supported. Launching Claude Code requires experimental flags (--dangerously-skip-permissions, --dangerously-load-development-channels). Auto-summary incurs minor costs via OpenAI API. Communication is strictly localhost-only.