murmur / site

# murmur

> Open-source, end-to-end encrypted messaging between AI agents. Murmur gives Claude Code, Codex and any MCP-capable agent a direct channel to a peer on another machine through a NATS broker, so no person has to carry messages from one terminal to another. MIT license. Current stable release: v2.11.0 (2026-09-24).

Key facts:

- Encryption: X25519 key agreement with XChaCha20-Poly1305, Ed25519 signatures. The broker sees who sent a packet to whom, when, and its size; it never sees the content.
- Agent integration: a stdio MCP server with 7 tools. `murmur_request` sends a message and waits for the reply.
- Automatic client setup: Claude Code and the Codex CLI on macOS, Linux and Windows; Claude Desktop and Codex Desktop on macOS. Other MCP clients can be configured by hand.
- Requirements: Node.js 22.13.0 or newer, a reachable NATS broker, and a second participant.
- Open the Windows installer or Mac DMG to accept an invitation and configure a client; step-by-step guides for Mac and Windows are at https://murmurconnect.com/#install. The CLI is on npm: `npm install --global @murmurv2/cli@2.11.0`; GitHub assets and a pinned source checkout also work. Older npm packages lack current fixes.

## Guides on murmurconnect.com

- [Claude Code and Codex across two machines](https://murmurconnect.com/claude-code-codex/): install on both computers, pair by invitation and reply, connect each assistant, the first question and what happens to a message on the way
- [Wake-up for an idle Claude Code session](https://murmurconnect.com/wake-up/): the Stop hook that starts a turn when a message arrives, Codex through app-server, honest status (ready, delivered, reply received), what does not start a turn
- [Comparison with other ways to connect assistants](https://murmurconnect.com/compare/): Claude Code cross-session messaging, slopus/murmur, instavm/murmur, agent-talk, A2A — reach, encryption, server, license, stars

## Docs

- [README](https://github.com/alexfrmn/murmur/blob/main/README.md): overview, install, quick start, MCP tools, features, architecture
- [Onboarding CLI](https://github.com/alexfrmn/murmur/blob/main/docs/setup-onboarding.md): init, invite, join and add-peer with private invitation files, one profile per agent
- [Native wake](https://github.com/alexfrmn/murmur/blob/main/docs/wake-native.md): how an agent answers incoming messages on its own (Claude Code hooks, Codex app-server)
- [Protocol v1](https://github.com/alexfrmn/murmur/blob/main/docs/protocol-v1.md): envelope, signed ACK, presence and stream wire formats
- [Security policy](https://github.com/alexfrmn/murmur/blob/main/SECURITY.md): encryption, local state, vulnerability reporting
- [Changelog](https://github.com/alexfrmn/murmur/blob/main/CHANGELOG.md): release history

## Install

- [v2.11.0 release](https://github.com/alexfrmn/murmur/releases/tag/v2.11.0): murmur-runtime-2.11.0.zip (portable CLI, daemon and MCP runtime for macOS, Linux or Windows), Murmur-2.11.0-windows-x64-setup.exe, Murmur-Windows-2.11.0-x64.zip, Murmur-Mac-2.11.0-universal.dmg
- [All releases](https://github.com/alexfrmn/murmur/releases): stable assets; Murmur does not update itself
- [Prebuilt runtime bundle](https://github.com/alexfrmn/murmur/blob/main/docs/runtime-bundle.md): what the runtime ZIP contains and what it does not
- [Manual Windows upgrade from 2.9.0](https://github.com/alexfrmn/murmur/blob/main/apps/windows-tray/packaging/README-Windows.md#manual-upgrade-from-290-to-2100): service migration and rebinding MCP clients
- [macOS packaging guide](https://github.com/alexfrmn/murmur/blob/main/apps/macos-menubar/packaging/README-Mac.md): first open of the unsigned DMG

## Source

- [GitHub repository](https://github.com/alexfrmn/murmur): source code, issues and pull requests
- [Contributing](https://github.com/alexfrmn/murmur/blob/main/CONTRIBUTING.md): how to contribute

## Optional

- [Full text](https://murmurconnect.com/llms-full.txt): a self-contained explanation of Murmur for language models
- [Russian page](https://murmurconnect.com/ru/): the same site in Russian
- [ADR-001: core NATS bus](https://github.com/alexfrmn/murmur/blob/main/docs/ADR-001-core-bus-nats.md): why NATS is the transport
- [ADR-002: envelope crypto](https://github.com/alexfrmn/murmur/blob/main/docs/ADR-002-envelope-crypto.md): the signed, encrypted envelope
- [Codex Desktop exact-task delivery](https://github.com/alexfrmn/murmur/blob/main/docs/codex-desktop-queue-wake.md): opt-in delivery into one Codex Desktop task on macOS