claude-peers-mcp-inter-instance-messaging — Claude Code skill
claude-peers-mcp-inter-instance-messaging — a skill that sets up the claude-peers MCP server so Claude sessions on one machine discover each other and exchange messages through a local broker.
no license 228 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a claude-codeWhat claude-peers-mcp-inter-instance-messaging does
The skill walks through installing the claude-peers MCP server, after which separate Claude sessions can see one another. A broker daemon holds state in SQLite and listens on localhost:7899. Each session starts its own MCP server, registers with the broker and checks for incoming mail once a second.
Four tools ship with it. list_peers takes a scope of machine, directory or repo and returns sessions with their working directory, git branch and a note on current work. send_message delivers text to a targetPeerId. set_summary publishes what a session is busy with. check_messages polls by hand, though you rarely need it because inbound notes arrive over the claude/channel protocol. Peers that stop answering get cleaned up.
Launch Claude with --dangerously-load-development-channels server:claude-peers. Drop that flag and the channel never opens, so nothing shows up on its own and you are left polling. The server runs on bun, which has to be present before the first start. Setting OPENAI_API_KEY turns on a startup summary written with gpt-5.4-nano; otherwise the session writes its own note via set_summary.
What it helps with
- locate other Claude sessions running on the same machine
- send a note to a sibling terminal without switching to it
- publish what a session is working on so peers can read it
- check whether a neighbour is already editing the same file
- inspect broker state and peer list from the command line
Example prompts for the agent
- Show me every peer running on this machine
- Send peer
abc123a note: are you editingauth.tsright now? - Set my summary to: rolling out v2.1, do not push to
main
How to install claude-peers-mcp-inter-instance-messaging
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a claude-code2Manually: put the files in place
~/.claude/skills/claude-peers-mcp-inter-instance-messaging/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/claude-peers-mcp-inter-instance-messaging/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a codex2Manually: put the files in place
.agents/skills/claude-peers-mcp-inter-instance-messaging/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a cursor2Manually: put the files in place
.cursor/skills/claude-peers-mcp-inter-instance-messaging/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/claude-peers-mcp-inter-instance-messaging2Manually: put the files in place
.github/skills/claude-peers-mcp-inter-instance-messaging/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/claude-peers-mcp-inter-instance-messagingManually: put the files in place
.devin/skills/claude-peers-mcp-inter-instance-messaging/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about claude-peers-mcp-inter-instance-messaging
How do I install claude-peers-mcp-inter-instance-messaging in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a claude-code. The skill file lands at ~/.claude/skills/claude-peers-mcp-inter-instance-messaging/SKILL.md.
What does claude-peers do?
It gives Claude sessions a shared channel: they find each other by machine, directory or repository, swap messages and read a short note about what a peer is doing. Traffic goes through a broker on localhost:7899.
Do I need an Anthropic API key?
Only for the automatic summary at startup, which uses gpt-5.4-nano. Without OPENAI_API_KEY the session sets its own description with set_summary.