Установка и обновление

Сверено с выпуском 0.36.0, 14.11.2026.

Pulse умеет собираться для macOS (Apple Silicon и Intel), Windows (x64) и Ubuntu (x64). Последний выпуск — 0.36.0 (12 ноября 2026) — собран только для Mac на Apple Silicon: пока работа идёт на Mac, сборки Windows, Linux и Mac Intel вернутся к кандидату 0.95. Для этих систем на сайте лежат установщики прежних выпусков: какая версия опубликована для вашей системы, показывает её карточка на странице скачивания. Что работает на каждой системе, а что пока только на macOS — в Платформах и сборках.

После установки Pulse попросит войти: через браузер или по почте — см. Вход, лицензии и кабинет.

Windows

Скачайте Pulse-<версия>-x64-setup.exe со страницы скачивания Pulse и откройте его. Вопросов нет: Pulse ставится для вас, в %LOCALAPPDATA%\Programs\pulse, без прав администратора, создаёт ярлыки на рабочем столе и в меню «Пуск» и открывается сам. Другая папка — из командной строки: Pulse-<версия>-x64-setup.exe /D=D:\Apps\Pulse. Приложение не подписано сертификатом Authenticode, поэтому SmartScreen предупредит о неизвестном издателе: «Подробнее» → «Выполнить в любом случае».

Если раньше Pulse был установлен «для всех пользователей» (так мог спросить установщик до 0.31.11), новый установщик предложит удалить ту копию — Windows попросит подтверждение администратора. Откажетесь — останутся две копии, у каждой своя строка в «Приложениях». Если вы согласились, а общая копия так и не удалилась, установщик скажет об этом окном с кодом PULSE-INSTALL-001 — в статье по шагам, как удалить её самому. Копия, которую вы раньше поставили для себя в свою папку, там и остаётся: установщик её находит.

ZIP без установки находится среди файлов выпуска GitLab (последний выпуск со сборкой Windows — 0.33.0); для него нужен доступ к проекту.

Ubuntu

.AppImage последнего выпуска со сборкой Linux (0.33.0) — на сайте Pulse. Linux-сборки выходят не с каждым выпуском: если для вашей версии файла нет, соберите на Linux из исходников через npm run pack:linux (см. Разработку).

Pulse-<версия>.AppImage — сделайте исполняемым и запустите:

chmod +x Pulse-*.AppImage && ./Pulse-*.AppImage

DEB находится среди файлов выпуска GitLab и требует доступа к проекту. Он ставится в систему вместе с зависимостями:

sudo apt install ./Pulse-*.deb

Ubuntu 22.04 и новее: AppImage просит FUSE

AppImage собирается electron-builder с прежним исполнителем на FUSE 2 (в package.json не задан toolsets.appimage), а Ubuntu с 22.04 из коробки ставит только FUSE 3. Без библиотеки запуск обрывается так:

dlopen(): error loading libfuse.so.2
AppImages require FUSE to run.

Поставьте библиотеку — пакет называется по-разному в разных выпусках:

sudo apt install libfuse2      # Ubuntu 22.04
sudo apt install libfuse2t64   # Ubuntu 24.04 и новее

Пакет fuse (без цифры) не ставьте: на 22.04 он удаляет fuse3, от которого зависит рабочий стол. Без прав администратора AppImage можно запустить и без FUSE — ./Pulse-*.AppImage --appimage-extract-and-run: он распакуется во временную папку при каждом запуске, это медленнее. DEB от FUSE не зависит.

Ubuntu 24.04: AppArmor и песочница

С 24.04 Ubuntu запрещает обычным программам создавать пространства имён пользователя (kernel.apparmor_restrict_unprivileged_userns=1), а на них стоит песочница Chromium, внутри которого работает окно Pulse. AppImage тогда окна не открывает и пишет:

The SUID sandbox helper binary was found, but is not configured correctly.
Rather than run without sandboxing I'm aborting now.

DEB этой проблемы не знает: electron-builder кладёт в пакет профиль AppArmor и при установке сам загружает его в /etc/apparmor.d/ (шаблон apparmor-profile.tpl в app-builder-lib; на 22.04 профиль пропускается — там он не нужен).

Для AppImage — свой профиль. Положите AppImage в постоянное место, например ~/Applications/, и разрешите пространства имён ровно ему:

sudo tee /etc/apparmor.d/pulse-appimage >/dev/null <<'PROFILE'
abi <abi/4.0>,
include <tunables/global>

profile pulse-appimage @{HOME}/Applications/Pulse-*.AppImage flags=(unconfined) {
  userns,
  include if exists <local/pulse-appimage>
}
PROFILE
sudo apparmor_parser -r /etc/apparmor.d/pulse-appimage

Профиль повторяет тот, что electron-builder ставит вместе с DEB, только привязан к пути AppImage. Проверен по шаблону electron-builder и разборам Ubuntu, но не прогнан на стенде Pulse с 24.04 — если окно всё равно не открывается, напишите нам в отчёте об ошибке. Другой путь к файлу — поправьте путь в профиле.

Чего не делать:

  • --no-sandbox откроет окно, но выключит песочницу Chromium для всех процессов окна Pulse: ошибка в разборе показанного содержимого перестаёт быть заперта внутри песочницы. Годится, чтобы убедиться, что дело в AppArmor, — не чтобы работать.
  • sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0 снимает запрет для всех программ машины сразу, а не для одного Pulse.

macOS

  1. Скачайте DMG для своего процессора — Apple Silicon или Intel — со страницы скачивания Pulse.
  2. Откройте образ, перетащите Pulse в «Программы», образ извлеките (иначе приложение запустится прямо из образа и будет вести себя странно).
  3. Откройте Pulse из «Программ». Если macOS спросит, хотите ли вы открыть приложение, скачанное из интернета, нажмите «Открыть».

Это обычное подтверждение первого запуска приложения из интернета — Apple описывает его отдельно от блокировки Gatekeeper.

Обе сборки подписаны Developer ID AVATEK, OOO и прошли нотаризацию Apple; Gatekeeper принимает их как Notarized Developer ID. Актуальная версия и ссылка для каждого процессора — в карточке своей платформы:

Процессор Последний выпуск
Apple Silicon 0.36.0
Intel прежний выпуск — номер в карточке на сайте; сборки Intel вернутся к кандидату 0.95

Автообновление предлагает только более новый номер. Чтобы переставить ту же версию, закройте Pulse и замените приложение из DMG вручную.

Почему macOS блокирует первый запуск

До 6 октября 2026 файлы Pulse не были нотариализованы (0.31.14 — Developer ID без нотаризации, ещё раньше — локальная подпись Pulse Dev или ad-hoc), и Gatekeeper их не пропускал. С 6 октября каждый DMG нотариализован. Если macOS всё равно предупреждает о неподтверждённом разработчике, скачайте актуальный DMG с сайта; если предупреждение остаётся с новым файлом, сообщите точное имя файла и текст ошибки в отчёте о проблеме.

Что спросит macOS при первом запуске

Запрос Зачем Что нажать
Доступ к ключу «Pulse Safe Storage» в связке ключей это ключ шифрования, не сами секреты. Ключи API, токены GitHub/GitLab и облачная сессия лежат в secrets.json в папке данных и читаются этим ключом «Разрешать всегда». «Разрешить» покрывает один доступ. Сколько раз окно появится за запуск, не зафиксировано
Управление Terminal.app вход агентов: Pulse открывает Terminal с командой входа самого агента (codex login, kimi login и т. п.) «Разрешить». Можно потом изменить в Системных настройках → Конфиденциальность → Автоматизация
Доступ к Документам / Загрузкам / Рабочему столу git-операции в репозиториях, которые лежат в этих папках «Разрешить» для тех папок, где у вас код
Уведомления центр уведомлений Pulse: агент отвалился, вышло обновление на ваше усмотрение

«Разрешать всегда» macOS запоминает для подписи того Pulse, который спросил доступ, а не для номера версии. Другая подпись для связки ключей — другое приложение: ad-hoc (у каждой сборки свой хэш кода), локальный сертификат «Pulse Dev» и Developer ID согласие друг другу не передают. Пока подпись той же копии не меняется, повторять согласие не нужно, и запрос после каждого обновления не обязателен. Если окно приходит при каждом запуске одной и той же копии — см. Если что-то пошло не так.

Мастер настройки

При первом запуске Pulse сам открывает мастер. Он нужен, чтобы не искать по настройкам, что где включается. Шагов пять; шаг про модель не показывается, если агент или своя модель уже найдены. Счётчик считает только видимые шаги.

  1. Какой агент будет первым? — агенты, которые уже стоят на компьютере. У ненайденного видна команда установки: «Установить» открывает её в терминале, «Проверить снова» ищет программы заново. Вход в аккаунт агента Pulse не перехватывает: открывается терминал с командой самого CLI.
  2. Чем будет думать агент — только если нет ни агента, ни готовой модели: подписка, свой сервер или GigaChat.
  3. Как работают агенты — у каждой задачи своя ветка и worktree; что агент делает сам («Спрашивать» или «Полный доступ»), а о чём спросит; какие умения Pulse ему даёт.
  4. Внешний вид — тема, шрифты и масштаб.
  5. Уведомления, Pulse Mobile и интеграции — когда Pulse скажет, что агент закончил или ждёт вас, и задачи из GitHub и GitLab.

Мастер показывается, пока его не закрыли, а не «пока не появится агент». Закрыть можно на любом шаге. Открыть заново — Настройки → Справка → «Мастер настройки». После мастера, пока нет ни проектов, ни задач, открывается экран «Над чем работаем?»: найденные на диске репозитории, открыть папку, клонировать, новый проект — и готовые первые задачи. Что ещё сделать — чек-лист Настройки → Первые шаги.

Подключение агента

Pulse не привозит с собой модель: он подключает агентов, которые у вас уже установлены (Claude Code, Codex, Grok, Gemini CLI, Kimi Code, OpenCode и другие), а агентов реестра ACP ставит сам с проверкой sha256. Кроме мастера то же самое на двух страницах: Настройки → Агенты и Настройки → Модели (группа «Агенты и AI»). Подробности — в Агенты и модели.

Обновления

Переход на 0.31.10. Ключ подписи обновлений заменён: любая версия до 0.31.10 доверяет прежнему ключу и новый выпуск не примет. Один раз скачайте установщик 0.31.10 или новее для своей системы с сайта Pulse, закройте Pulse и установите вручную. Карточки показывают фактически опубликованные версии: если для вашей платформы новой сборки ещё нет, доступен прежний выпуск. После ручной установки клиент проверяет следующие выпуски новым ключом.

  • Если включено Облако (Настройки → Облако), Pulse сам проверяет сервер обновлений. Новая версия качается в фоне (выключается там же, в «Обновлениях») и проверяется; индикатор говорит «Обновление … готово». «Перезапустить и обновить…» даёт выбрать момент: «Когда агенты закончат», «При следующем запуске» или «Остановить и обновить сейчас»; без работающих агентов — «Перезапустить сейчас». Молча поверх работы агентов Pulse не обновляется.
  • После обновления в колокольчике уведомлений появляется «Pulse обновлён до X» с кнопкой «Что нового»: окно показывает рассказ о версии (что было не так, что теперь, чего Pulse не знает) по модулям. Открыть его можно и из меню Справка → Что нового или Настройки → О программе.
  • Обязательные обновления помечаются отдельно: их лучше ставить сразу, иначе старая версия может не понять новые данные.

Что Pulse проверяет и чего он не знает

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

  • файл берётся только у того же сервера, что ответил на проверку, и по тому же протоколу: подменённый ответ не может увести скачивание на чужой адрес;
  • имя файла должно быть пакетом для этой системы (.dmg/.zip, .exe/.msi, .deb/.rpm/.AppImage) — скрипт или произвольный исполняемый файл Pulse не примет;
  • сервер обязан назвать sha512; без неё релиз отклоняется, не дойдя до скачивания;
  • версия, платформа, канал, имя файла, сумма и размер должны иметь Ed25519-подпись, которую клиент проверяет встроенным открытым ключом выпуска;
  • предлагается только версия новее установленной — откат обновлением не делается;
  • сумма сверяется дважды: после скачивания и ещё раз в момент установки. Между этими двумя моментами проходят часы, а файл лежит в папке данных — если его подменили, установка не начнётся, файл будет удалён, а Pulse скажет почему;
  • скачанное не ставится само: установка начинается только с выбранного вами момента. На Windows Pulse закрывается, и установщик ставит новую версию в фоне, без окон, — и открывает её. Тихо обновляется только копия, поставленная для вас; копия «для всех пользователей» и ZIP получают окно установщика. На macOS Pulse сам подменяет приложение в «Программах» из проверенного образа, если у нового приложения тот же bundle id, та же версия, что в выпуске, целая подпись и тот же сертификат, что у установленного; любое расхождение (запуск прямо из образа, другая подпись, нет прав на папку) — и Pulse открывает образ для ручной установки, говоря почему.

Подпись манифеста подтверждает, что выпуск одобрен владельцем ключа, и связывает файл с объявленной суммой. Она не доказывает, кто собрал этот файл, и не заменяет сертификат подписи приложения для операционной системы. Поэтому Pulse не заменяет себя без вашего выбора (и поэтому в нём нет electron-updater): молчаливая подмена приложения файлом, издателя которого подтвердить нечем, опаснее ручной установки. На Windows окно установщика ничего к проверке не добавляло — файл, скачанный самим Pulse, SmartScreen не проверяет, а установка для пользователя не просит прав, — поэтому установщик идёт без окон; проверки суммы и подписи манифеста те же. Что именно произойдёт при установке, перечислено по шагам в Настройки → Облако → Обновления — до нажатия, а не после.

  • После установки новая версия сама удаляет скачанные пакеты не новее себя (updates в папке данных), а на macOS ещё и извлекает образ прошлого обновления. Если том ещё занят, уборка повторится при следующем запуске.
  • Без облака обновляйтесь вручную: скачайте свежий файл с сайта и поставьте поверх установленного. Данные, задачи и ключи остаются на месте.
  • Сервер обновлений различает системы: приложение просит файл именно для своей связки системы и архитектуры. Извлечение образов после обновления — только на macOS.

Где лежат данные

  • macOS: ~/Library/Application Support/Pulse (у сборки из исходников — .../pulse)
  • Windows: %APPDATA%\Pulse
  • Linux: ~/.config/Pulse

Внутри одинаково:

Путь Что
pulse-tasks.db, pulse-sessions.json задачи (SQLite, решение 0034; pulse-tasks.json — снимок прежнего формата для MCP-сервера) и сессии
transcripts/<sessionId>.jsonl полная запись сессии: каждый ход, вызов, разрешение
pulse-activity.json журнал активности (последние 400 записей)
pulse-settings.json агенты, папки, внешний вид, рои, политики, MCP, профили
secrets.json ключи и токены, зашифрованы через связку ключей, права 0600
logs/pulse.log журнал приложения (секреты маскируются)
memory/<имя>-<хэш>.md память репозитория: итоги задач и решения
worktrees/<taskId> worktree задач
checkpoints/ снимки ходов для «Откатить ход» (с 0.34)
scratch/<taskId> задачи без репозитория
exports/ экспорт аудита и сохранённые отчёты об ошибке

Папку данных можно открыть кнопкой: Настройки → Справка → Папка данных → В Finder.

Удаление

Windows. «Параметры → Приложения → Pulse → Удалить» (или правый клик по Pulse в «Пуске» → «Удалить»). Деинсталлятор по шагам:

  1. Спрашивает, точно ли удалить Pulse.
  2. Если Pulse открыт — предлагает закрыть его; вместе с ним завершаются процессы из папки Pulse: демон терминала и встроенные codex.exe, claude.exe, rg.exe. CLI агентов, поставленные через npm, не трогаются.
  3. Спрашивает, удалить ли данные %APPDATA%\Pulse; ответ по умолчанию — «Нет». Вместе с данными пропадут worktree задач с незакоммиченными изменениями. Если часть файлов занята (терминал или редактор в worktree), деинсталлятор скажет об этом окном с кодом PULSE-UNINSTALL-001.
  4. Удаляет файлы, ярлыки, пункт «Открыть с помощью» для Markdown и схему pulse://, если она ведёт в эту копию.

Без вопросов: "%LOCALAPPDATA%\Programs\pulse\Uninstall Pulse.exe" /S оставляет данные, с --delete-app-data удаляет и их. Пункты 3–4 списка ниже относятся и к Windows.

macOS.

  1. Перетащите Pulse из «Программ» в корзину.
  2. Удалите данные, если они больше не нужны: ~/Library/Application Support/Pulse.
  3. Worktree задач лежат внутри папки данных; если вы меняли «Папку worktree» в «Настройки → Общие», удалите и её.
  4. Ветки задач (pulse/… или ваш префикс) остаются в ваших репозиториях — удалите их обычным git branch -D, если они не нужны.

Сборка из исходников

git clone https://github.com/NameLucky2205/pulse.git
cd pulse
npm install
npm run dev          # окно с горячей перезагрузкой

Если запускаете из-под другого Electron-процесса (например, из агента), снимите переменную, иначе Electron стартует как обычный Node:

env -u ELECTRON_RUN_AS_NODE npm start

Сборка своего DMG и публикация — в Разработке.