louislva

louislva / claude-peers-mcp

Public

Allow all your Claude Codes to message each other ad-hoc!

286
21
100% credibility
Found Mar 22, 2026 at 287 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

This project allows multiple Claude Code sessions running on the same machine to discover one another, share project summaries, and exchange instant messages.

How It Works

1
💡 Discover the chat helper

You hear about a handy tool that lets your multiple AI coding buddies on the same computer find each other and chat instantly across projects.

2
📥 Download and set up

Grab the simple files to your computer and prepare them so they're ready to connect your AI sessions.

3
🔗 Link it to your AI tool

Tell your AI coding program to always have this chat feature available whenever you start a session.

4
🚀 Start your first AI session

Launch your AI coding helper with the chat turned on, and it quietly starts a background matchmaker to connect with others.

5
💬 Chat across sessions

Open a second AI session, ask one to find the others and send a quick message like 'What files are you editing?', and watch it arrive instantly in the other window.

🎉 Your AIs team up

Now all your AI helpers see each other's projects, share summaries of what they're doing, and respond right away, making multi-project work feel like a collaborative team.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 287 to 286 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-peers-mcp?

This TypeScript project, powered by Bun, lets multiple Claude Code sessions discover each other across terminals and exchange instant messages. It solves the chaos of running several Claude instances for different projects: list peers scoped to machine, directory, or repo; send messages that push via channels for immediate arrival; set summaries of your work. Register once as an MCP server, then launch Claude with a flag—CLI tools handle status checks, sending messages, or killing the broker.

Why is it gaining traction?

Instant peer messaging via channels beats manual context-switching, with auto-summaries (via optional OpenAI key) giving context like git branch and recent files. Tools like list_peers and send_message make Claudes act like networked coworkers, enabling ad-hoc coordination without leaving your terminal. The localhost-only broker auto-starts, cleans dead peers, and supports CLI overrides—developers dig the low-friction multi-session flow.

Who should use this?

Full-stack devs running Claude Code on frontend/backend repos simultaneously, backend engineers coordinating across microservices directories, or AI-assisted coders multitasking git worktrees. Ideal for Claude Code v2.1+ users on macOS/Linux who want peers to query files, share insights, or collaborate without copy-paste.

Verdict

Grab it if multi-Claude workflows are your jam—286 stars show niche appeal, docs are crisp, but 1.0% credibility flags it as early-stage (test thoroughly). Skip for solo sessions; scales well for power users.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.