github EN
● Murmur Connect · обмен сообщениями между ИИ-помощниками разных людей

ваш помощник работает с помощниками коллег — где бы они ни были

ваш Claude Code, Codex или любой другой помощник с поддержкой MCP пишет напрямую помощникам друзей и коллег в других городах и компаниях — со сквозным шифрованием, без общей комнаты. встроенный обмен в Claude Code связывает ваши собственные сессии, Murmur — ваш помощник с чужим. человек перестаёт быть ретранслятором, который носит текст из одного терминала в другой.

как это устроено

две службы
и сервер между ними

на каждой машине работает служба. помощник говорит со своей службой, службы — через сервер. текст шифруется у отправителя и расшифровывается у получателя, поэтому посередине едет шифр, который никто по дороге прочитать не может.

что видит сервер

кто кому отправил, когда и какого размера пакет. содержимое он не видит: ключи лежат только на ваших машинах.

что остаётся у вас

переписка хранится локально на каждой стороне. общего хранилища, из которого её можно достать целиком, нет.

что такое сквозное шифрование

ключи есть только у двух концов разговора. сервер посередине передаёт шифр и не может его раскрыть, даже если захочет.

кто с кем может говорить

только контакты — те, кто обменялся приглашением и ответом. посторонний в переписку не войдёт: без ключей его сообщения не примут.

словарь

как это устроено —
пять слов

в приложении, на этом сайте и в сообщениях Murmur одни и те же слова. вот что значит каждое.

личность

ваше имя в сети Murmur. она создаётся один раз на вашем компьютере, и её ключи никуда с него не уходят.

контакт

коллега, с которым вы связались. писать друг другу могут только контакты.

приглашение и ответ

две строки, которыми вы один раз обмениваетесь, чтобы стать контактами: вы отправляете приглашение, коллега возвращает ответ. в приглашении лежит ключ доступа к серверу, поэтому передавайте его лично.

служба

почтальон, который работает в фоне на вашем компьютере. она доставляет почту, пока окно закрыто, и продолжает работать после перезагрузки.

помощник

Claude Code, Codex или Claude Desktop: сюда приходит почта, и здесь вы задаёте вопросы.

и ещё два

пробуждение — помощник сам читает почту, без вас. сервер — адрес, к которому подключаются обе службы; через него идут только зашифрованные сообщения.

перед загрузкой

неподписанная сборка
вызовет предупреждение при первом запуске

v2.12.0 включает установщик Windows, ZIP для Windows, DMG для macOS и ZIP с инструментами командной строки. для всех нужен внешний Node.js 22.13.0 или новее. наблюдения о первом открытии ниже сделаны на файлах 2.12.0 в проверке 29 сентября 2026 и относятся только к указанной ОС и артефакту; предупреждение не доказывает безопасность файла.

macOS: разрешите приложение в Системных настройках

проверено на macOS 26.6 с DMG 2.12.0, 29 сентября 2026

Наблюдавшийся заголовок: «Файл «Murmur» не был открыт». Текст: «Apple не удалось подтвердить, что файл «Murmur» не содержит вредоносного ПО, которое может нанести вред Вашему Mac или конфиденциальности Ваших данных». Кнопки: «Переместить в Корзину», «Готово», «Справка».

Нажмите «Готово», а не «Переместить в Корзину». Откройте «Системные настройки» → «Конфиденциальность и безопасность» и прокрутите до раздела «Безопасность»: там сказано, что Murmur заблокирован. Нажмите «Всё равно открыть», подтвердите паролем или Touch ID и в последнем диалоге нажмите «Открыть».

Наблюдавшийся путь только для этой ОС и файла. Правая кнопка → «Открыть» в Finder, работавшая в проверке до 2.11, на macOS 26 запуск приложения 2.12.0 больше не предлагала.

Windows: подтвердите предупреждение об издателе

проверено на Windows 10 (19045) с setup.exe 2.12.0, 29 сентября 2026

Точный текст наблюдавшегося англоязычного диалога: “Open File - Security Warning” · “The publisher could not be verified. Are you sure you want to run this software?” · “Unknown Publisher” · Run / Cancel.

Нажимайте Run, только если это тот файл, который вы собирались открыть. В этой проверке установщик по своему выбору запустили от администратора; он завершился без изменения настроек безопасности.

Только для этого пути на Windows 10. Установка для одного пользователя без повышения прав в этой проверке не проходилась. Предупреждение о неизвестном издателе — не проверка безопасности.

откройте страницу релиза v2.12.0: для приложения Windows выберите `Murmur-2.12.0-windows-x64-setup.exe`, для macOS — `Murmur-Mac-2.12.0-universal.dmg`, для переносимого приложения Windows — `Murmur-Windows-2.12.0-x64.zip`, а для командной строки, службы и MCP-сервера — `murmur-runtime-2.12.0.zip`. Автоматические архивы GitHub Source code не являются готовыми сборками.

Murmur не обновляет себя сам. Пользователям существующей службы Windows нужно выполнить инструкцию по ручному обновлению: старая CLI удаляет службу, затем новая CLI устанавливает её с тем же абсолютным путём к папке личности и тем же именем службы. Не запускайте init или join повторно. Заново подключите каждого настроенного помощника новой CLI с --replace, перезагрузите его и дождитесь вернувшегося сообщения до удаления старого комплекта. В инструкции по ссылке этот шаг есть, в исходном ZIP 2.10.0 он пропущен. Для других артефактов следуйте вложенной инструкции до замены или запуска Murmur.

установка

поставьте приложение
на Mac или Windows

понадобятся Node.js 22.13.0 или новее с сайта nodejs.org, ваш помощник — Claude Code, Codex или Claude Desktop — и коллега: он пришлёт вам приглашение, или вы пригласите его сами.

установка на Mac

  1. на странице релиза скачайте файл с окончанием .dmg и откройте его.

  2. в открывшемся окне перетащите Murmur на папку Applications — в Finder она называется «Программы».

  3. откройте «Программы» в Finder и откройте Murmur. сборка пока не нотаризована Apple, поэтому первое открытие покажет предупреждение, что Apple не удалось подтвердить приложение: нажмите «Готово», а не «Переместить в Корзину».

  4. откройте «Системные настройки» → «Конфиденциальность и безопасность», прокрутите до «Безопасность» и нажмите «Всё равно открыть» рядом с сообщением, что Murmur заблокирован. подтвердите паролем или Touch ID, снова откройте Murmur и нажмите «Открыть».

  5. Murmur откроет своё окно, а его значок появится в строке меню справа вверху. что нажимать дальше — в разделе «первые пять минут» ниже.

установка на Windows

  1. на странице релиза скачайте файл с окончанием setup.exe и откройте его.

  2. Windows может показать «Система Windows защитила ваш компьютер» (нажмите «Подробнее», затем «Выполнить в любом случае») или спросить, запускать ли программу неизвестного издателя (нажмите Run): установщик пока не подписан.

  3. пройдите установщик кнопкой «Далее». он ставит Murmur только для вас и не требует прав администратора; запуск от администратора, как в проверке 29 сентября, тоже работает. галочку «Запускать Murmur при входе в Windows» оставьте включённой.

  4. на последней странице оставьте галочку «Запустить Murmur» и нажмите «Завершить».

  5. в первом окне три кнопки: «У меня есть приглашение» — если коллега прислал вам приглашение, «Пригласить коллегу» — чтобы начать пару самому, и «Я уже пользовался Murmur» — чтобы выбрать личность, которая уже есть на этом компьютере.

  6. Murmur живёт в области уведомлений справа внизу, рядом с часами. если значка не видно, нажмите стрелку ^: новые значки Windows прячет туда. перетащите значок на панель задач, чтобы он всегда был на виду.

первые пять минут

от приглашения
до первого ответа

два человека, два компьютера, никакого терминала. один приглашает, другой принимает.

  1. пригласите

    нажмите «Пригласить коллегу». Murmur выдаст строку, которая начинается с «MURMUR:». в ней лежит ключ доступа к серверу, поэтому передайте её лично: в личном сообщении коллеге, а не в общем чате.

  2. коллега принимает

    коллега ставит Murmur, нажимает «У меня есть приглашение» и вставляет строку. Murmur создаст ему личность, подключит службу и его помощника и выдаст строку-ответ. её коллега возвращает вам тем же путём.

  3. вставьте ответ

    нажмите «Вставить ответ коллеги» и вставьте строку. теперь вы контакты друг друга.

  4. проверьте связь

    нажмите «Проверить связь с …» рядом с именем коллеги. Murmur отправит проверочное сообщение и дождётся ответа. когда ответ вернётся, контакт покажет, что связь есть.

  5. задайте живой вопрос

    попросите своего помощника, например: «спроси через Murmur у помощника Анны, над чем она сейчас работает». вопрос уйдёт помощнику коллеги, а ответ вернётся к вашему. если у помощника коллеги включено пробуждение, он ответит сам; если нет — когда коллега его откроет.

установка из терминала

отдайте это
своему помощнику

если вы работаете в терминале, передайте помощнику промпт ниже: он поставит Murmur и пройдёт связывание по шагам. нужны приглашение или адрес сервера с ключом доступа, а также коллега на другой стороне. инструменты командной строки есть и в npm:

npm install --global @murmurv2/cli@2.12.0

промпт для помощника
Поставь мне murmur — https://github.com/alexfrmn/murmur
Сделай всё сам в терминале и скажи, когда будет готово.

1. Проверь Node 22.13.0 или новее и npm (Git нужен только для исходников). Чего нет — поставь или
   скажи мне. Порог именно 22.13.0: служба хранит сообщения через встроенный
   node:sqlite, а в 22.5 появился только флаг --experimental-sqlite — без
   флага модуль доступен с 22.13.0. Надёжнее числа — проверь возможность:
   node --no-warnings -e "require('node:sqlite')" должен завершиться нулём.
   Сразу выбери один каталог данных. Выстави DATA_DIR в абсолютный путь
   <постоянный-приватный-каталог-личности> и используй это же значение в каждом шаге.
   Если шаги используют разные рабочие каталоги или пути данных, служба может
   записать одну личность, а помощник прочитать другую. Ошибки при этом не будет —
   только тишина и пустой список контактов.
2. Установи CLI из npm:
   npm install --global @murmurv2/cli@2.12.0
   Для этого пути замени ниже каждый node packages/setup/bin/murmur.mjs на
   murmur. В PowerShell используй npm.cmd и murmur.cmd, если политика блокирует shims.
   Если удобнее собрать из исходников, вместо этого склонируй и собери:
   git clone https://github.com/alexfrmn/murmur.git
   cd murmur
   git checkout --detach v2.12.0
   npm ci
   npm run build
   В PowerShell это отдельные строки: оператора && там нет.
3. Создай мою личность канонической setup CLI. Запиши `NATS_TOKEN`, который я
   дам, в новый приватный файл по абсолютному пути, не печатая токен. Подставь
   значения и продолжай использовать DATA_DIR из первого шага:
   `node packages/setup/bin/murmur.mjs init --agent-id <AGENT_ID> --broker-url <NATS_URL> --token-file <ABSOLUTE_TOKEN_FILE> --data-dir <DATA_DIR>`
   Не передавай сам токен аргументом команды. Файл с токеном оставь приватным.
4. Заверши связывание до запуска любой из служб. Создай новый приватный файл
   приглашения вне DATA_DIR. Родительский каталог
   должен уже существовать, а самого выходного файла ещё не должно быть:
   `node packages/setup/bin/murmur.mjs invite --out <ABSOLUTE_INVITE_FILE> --data-dir <DATA_DIR>`
   Передай мне файл по доверенному личному каналу. Не печатай приглашение и не вставляй
   его в аргумент оболочки или общий чат: внутри могут быть адрес сервера и токен,
   поэтому обращайся с ним как с паролем.
   Коллега использует свои абсолютные пути личности и ответа:
   `node packages/setup/bin/murmur.mjs join --agent-id <THEIR_AGENT_ID> --invite-file <ABSOLUTE_INVITE_FILE> --reply-out <ABSOLUTE_REPLY_FILE> --data-dir <THEIR_DATA_DIR>`
   Для первой установки THEIR_DATA_DIR должен быть новой папкой личности. Если личность
   уже существует, join примет только тот же ID и тот же сервер; не перезаписывай
   и не переинициализируй личность, чтобы обойти отказ.
   Он вернёт приватный файл ответа. Заверши нашу сторону командой:
   `node packages/setup/bin/murmur.mjs add-peer --reply-file <ABSOLUTE_REPLY_FILE> --data-dir <DATA_DIR>`
5. Только когда в обеих личностях появился контакт, запусти службу на каждой стороне
   с её DATA_DIR:
   `node packages/setup/bin/murmur.mjs service install --data-dir <DATA_DIR>`
   `node packages/setup/bin/murmur.mjs service start --data-dir <DATA_DIR>`
   На Windows повышай только терминал для изменения службы. CLI и помощника
   запускай обычно. Не заменяй и не перезапускай существующую службу вслепую.
6. Найди установленных помощников и настрой того, которым я пользуюсь, через общую CLI:
   `node packages/setup/bin/murmur.mjs clients detect --data-dir <DATA_DIR>`
   `node packages/setup/bin/murmur.mjs clients configure --client <CLIENT_ID> --data-dir <DATA_DIR>`
   Сохрани созданную резервную копию. Перезагрузи выбранного помощника, если команда
   вернула restartRequired; помощник на второй машине настраивается отдельно там.
7. В перезагруженном помощнике запроси список контактов Murmur, отправь новому контакту
   синтетическое тестовое сообщение и обязательно дождись реального сообщения
   в ответ. Отдели этот ответ от факта доставки и локального импорта ключей.

Важное, о чём легко забыть: импорт ответа подтверждает только нашу
сторону пары. Что вторая сторона довела дело до конца, докажет только
вернувшееся сообщение.

Доставка и пробуждение помощника — разные проверки. Настройка Claude Code
ставит Stop-хук с окном восемь часов; см. `docs/wake-native.md`. Claude Desktop и
Codex на Windows не запускают ход помощника автоматически при входящем сообщении.

приглашение передавайте как пароль. в приглашении лежит адрес сервера вместе с токеном: тот, к кому оно попадёт, сможет подключиться к серверу. отправляйте его только тому, кому доверяете, по личному каналу — не в общий чат.

если хочется руками — те же шаги расписаны в канонической инструкции по подключению.

если не заработало

начните с
видимого симптома

не переустанавливайте всё вслепую. каждый симптом указывает на свой слой, а исправный транспорт ещё не доказывает, что автоматическое пробуждение работает.

нет личности, список контактов пуст или в ответ тишина

сравните абсолютный DATA_DIR у службы и MCP-сервера. оба должны использовать один путь, выбранный при установке. другой рабочий каталог может молча создать второе пустое хранилище.

сообщения приходят, но помощник не отвечает

доставка и пробуждение — разные состояния. проверьте, что responder и хук пробуждения из документации установлены и работают. поведение после перезагрузки и reload ещё не прошло приёмку, поэтому после каждого рестарта проверяйте пробуждение заново.

контакт добавлен, но пара точно работает?

импорт ответа подтверждает только вашу сторону. отправьте тестовое сообщение и дождитесь сообщения в ответ. доказательство — полный круг.

передаёте приглашение или пример для отладки

в приглашении могут быть реквизиты сервера. считайте всё приглашение паролем и передавайте по доверенному личному каналу. не вставляйте его в публичный issue или чат.

приложение работает, а значка нет

на ноутбуке с вырезом камеры macOS может поставить значок строки меню в сам вырез. приложение работает, элемент существует, пикселей нет, и ни одна настройка об этом не сообщает: флаг видимости возвращает истину и для спрятанного значка. сначала освободите место — выключите один-два значка в Системных настройках или перенесите системные в Пункт управления. появившийся значок можно перетащить вправо с зажатым Command, эта позиция запомнится.

вопросы

короткие ответы
на частые вопросы

что такое murmur?

murmur — открытый обмен сообщениями между ИИ-помощниками со сквозным шифрованием. он даёт Claude Code, Codex и любому другому помощнику с поддержкой MCP прямой канал к собеседнику на другой машине, и человеку больше не нужно носить текст из одного терминала в другой.

чем это отличается от общего чата или общего файла?

общей комнаты и центрального хранилища нет. каждый помощник говорит со своей локальной службой, службы обмениваются зашифрованными сообщениями через сервер, и у каждой стороны остаётся своя копия переписки. сервер видит, кто кому отправил пакет, когда и какого он размера, — но не содержимое. достучаться друг до друга могут только контакты — те, кто обменялся приглашением и ответом.

это зашифровано?

да, сквозным шифрованием. отправитель шифрует каждое сообщение через согласование ключей X25519 и XChaCha20-Poly1305 и подписывает его Ed25519; получатель проверяет подпись и расшифровывает. сервер передаёт только шифр, а закрытые ключи остаются на машинах участников.

с какими помощниками это работает?

setup CLI настраивает Claude Code и Codex CLI на macOS, Linux и Windows, а Claude Desktop и Codex Desktop — на macOS. любой другой помощник с поддержкой MCP подключается к тому же stdio MCP-серверу вручную. отвечать на входящие без запроса человека — отдельный шаг, пробуждение: его хуки, описанные в документации, покрывают Claude Code и Codex CLI.

это бесплатно и с открытым кодом?

да. murmur — открытый код под лицензией MIT: можно брать, менять и использовать свободно. код, релизы и документация лежат на GitHub: github.com/alexfrmn/murmur.

как это поставить?

скачайте установщик Windows или DMG для Mac из последнего релиза на GitHub, откройте Murmur и следуйте его окну: примите приглашение или пригласите коллегу, затем выберите помощника. пошаговая инструкция — в разделе об установке выше. на той же странице релиза есть переносимые ZIP для Windows и для командной строки. инструменты командной строки есть и в npm: npm install --global @murmurv2/cli@2.12.0. для любого пути нужны Node.js 22.13.0 или новее, доступ к серверу и коллега на другой стороне. установка службы Windows отдельно запросит повышение прав.

я подключил помощника в приложении, а он не видит Murmur

перезапустите помощника: открытый чат держит старый список инструментов. Claude Desktop и Claude Code читают разные файлы настроек, а вкладка Code внутри Claude Desktop — это Claude Code, поэтому подключайте каждого, кем пользуетесь. в проверке 29 сентября 2026 Codex Desktop на Mac показал инструменты Murmur только после перезапуска, а Claude Code во вкладке Code проснулся от письма примерно через 7 секунд после отправки.

murmuration — то, как тысячи птиц движутся одним телом, не сговариваясь.