Skip to main content
affpapa.org
RU EN
skill CX Codex

claude-peers-mcp — Claude Code skill: what it does, how to install

Enables parallel Claude Code sessions on one computer to locate each other and pass data in real time using a local message broker.

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

What claude-peers-mcp does

This skill coordinates separate Claude Code sessions running side by side. It relies on a background daemon listening on localhost:7899 and storing state in ~/.claude-peers.db. Every session starts an stdio MCP process, pings the broker every second, and receives updates through Claude channels.

The toolset includes list_peers, send_message, set_summary, and check_messages. Agents can discover other instances across the entire machine or inside a specific git repository. Passing an OPENAI_API_KEY environment variable lets gpt-4o-mini summarize what each session is doing based on git state and recent files.

Push delivery breaks under API key authentication because development channels require a direct claude.ai login. You also need the Bun runtime and Claude Code version 2.1.80 or newer.

What it helps with

  • coordinate tasks between frontend and backend terminal sessions
  • pass context directly to another Claude Code instance by ID
  • list running AI coding sessions inside the current git repo
  • dispatch instructions into a running session using the CLI helper

Example prompts for the agent

  • List all active Claude Code peers running on this machine
  • Send a message to peer abc123 asking which endpoints it expects
  • Check for any unread messages from other local sessions

How to install claude-peers-mcp

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill claude-peers-mcp -a claude-code

2Manually: put the files in place

~/.claude/skills/claude-peers-mcp/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about claude-peers-mcp

How to install claude-peers-mcp in Claude Code?

Run npx skills add reason-machines/trending-skills --skill claude-peers-mcp -a claude-code in your terminal.

What does claude-peers-mcp do?

It links multiple local Claude Code processes through an SQLite broker daemon on port 7899, enabling peer discovery and real-time messaging between sessions.

Why does instant message delivery fail with an API key?

Channel push functionality depends on a claude.ai account session, so running Claude Code solely with Anthropic API key authentication disables push delivery.

Similar skills

All skills for Agent setup: memory, context, orchestration →
setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set139

724-office-ai-agent Sets up an autonomous Python agent system with 26 built-in tools, three-tier memory, and MCP support. Useful when building continuous office automations with scheduled jobs. CX Codex +1 1,100installs weixin-agent-sdk This skill wires any AI backend into WeChat through the weixin-agent-sdk TypeScript framework: QR login plus a message loop. CX Codex +1 1,100installs ghostling-libghostty-terminal A skill that walks through building a minimal terminal emulator on the libghostty-vt C library, with Raylib handling windows and rendering. CX Codex +1 1,100installs flash-moe-inference Runs the Qwen3.5-397B Mixture-of-Experts model on Apple Silicon by streaming expert weights directly from an SSD in pure C and Metal. Designed for Macs with 48GB of memory. CX Codex +1 1,100installs polymarket-arbitrage-trading-bot A skill that builds a trading bot for Polymarket's 15-minute Up/Down markets: it watches BTC, ETH, SOL and XRP and buys both legs once their combined price drops under a threshold. CX Codex +1 979installs awesome-free-llm-apis A reference skill listing LLM providers with permanent free tiers, their rate limits, models and Anthropic-compatible setup. CX Codex +1 978installs awesome-phd-cv Creates LaTeX CV and resume layouts for PhD students and researchers. Use it for an academic CV or an ATS-ready industry resume. CX Codex +1 975installs web-access-claude-skill Lets the agent pick between search, page fetch and driving your real Chrome. Useful when a site sits behind a login or renders on JS. CX Codex +1 965installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor