Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/mcp-skills --skill claude-peers-mcp-inter-instance-messaging -a claude-code
Open on GitHub

What 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 abc123 a note: are you editing auth.ts right 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-code

2Manually: put the files in place

~/.claude/skills/claude-peers-mcp-inter-instance-messaging/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/claude-peers-mcp-inter-instance-messaging/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set98

The whole set →
excalidraw-mcp-server Walks an agent through building MCP servers which hand back interactive hand-drawn Excalidraw diagrams, streaming updates included. CX Codex +1 235installs awesome-mcp-servers-discovery awesome-mcp-servers-discovery — a skill that lets your agent search a curated catalogue of 6000+ MCP servers across 30+ categories and shows how to wire one up. CX Codex +1 233installs jcodemunch-mcp-code-retrieval The jcodemunch-mcp-code-retrieval skill lets an agent query repository symbols and their relationships through MCP. Use it to inspect a codebase by asking for specific implementations instead of browsing files line by line. CX Codex +1 230installs cve-mcp-server-security-intelligence cve-mcp-server-security-intelligence — a skill that runs a local MCP server and hands the agent 27 tools for CVE work: CVSS and EPSS scores, CISA KEV status, exploit hunting and a composite risk score. CX Codex +1 229installs pal-mcp-server-multi-model-orchestration The pal-mcp-server-multi-model-orchestration skill uses PAL MCP to bring multiple AI models into code reviews, debugging, and planning. Use it when you want another model to inspect a change. CX Codex +1 227installs anysearch-mcp-server anysearch-mcp-server connects your coding agent to live web search, 23 specialized data categories, and parallel batch queries. Useful when your workflow needs fresh market data, research papers, or web pages. CX Codex +1 226installs mcp-brasil-server mcp-brasil-server is a Claude Code skill that connects an agent to 70+ Brazilian public APIs through 533 tools for querying economic, legal, transparency, court, and election data. CX Codex +1 225installs mcp2cli-api-to-cli mcp2cli-api-to-cli converts MCP servers, OpenAPI specs, and GraphQL endpoints into CLI commands on the fly without codegen. It cuts context token usage by replacing heavy tool schemas with CLI calls. CX Codex +1 225installs

Project sponsors

Companies that keep this analytics open