Установка и обновление
Сверено с выпуском 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
- Скачайте DMG для своего процессора — Apple Silicon или Intel — со страницы скачивания Pulse.
- Откройте образ, перетащите Pulse в «Программы», образ извлеките (иначе приложение запустится прямо из образа и будет вести себя странно).
- Откройте 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 сам открывает мастер. Он нужен, чтобы не искать по настройкам, что где включается. Шагов пять; шаг про модель не показывается, если агент или своя модель уже найдены. Счётчик считает только видимые шаги.
- Какой агент будет первым? — агенты, которые уже стоят на компьютере. У ненайденного видна команда установки: «Установить» открывает её в терминале, «Проверить снова» ищет программы заново. Вход в аккаунт агента Pulse не перехватывает: открывается терминал с командой самого CLI.
- Чем будет думать агент — только если нет ни агента, ни готовой модели: подписка, свой сервер или GigaChat.
- Как работают агенты — у каждой задачи своя ветка и worktree; что агент делает сам («Спрашивать» или «Полный доступ»), а о чём спросит; какие умения Pulse ему даёт.
- Внешний вид — тема, шрифты и масштаб.
- Уведомления, 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 в «Пуске» → «Удалить»). Деинсталлятор по шагам:
- Спрашивает, точно ли удалить Pulse.
- Если Pulse открыт — предлагает закрыть его; вместе с ним завершаются процессы из папки
Pulse: демон терминала и встроенные
codex.exe,claude.exe,rg.exe. CLI агентов, поставленные через npm, не трогаются. - Спрашивает, удалить ли данные
%APPDATA%\Pulse; ответ по умолчанию — «Нет». Вместе с данными пропадут worktree задач с незакоммиченными изменениями. Если часть файлов занята (терминал или редактор в worktree), деинсталлятор скажет об этом окном с кодом PULSE-UNINSTALL-001. - Удаляет файлы, ярлыки, пункт «Открыть с помощью» для Markdown и схему
pulse://, если она ведёт в эту копию.
Без вопросов: "%LOCALAPPDATA%\Programs\pulse\Uninstall Pulse.exe" /S оставляет данные,
с --delete-app-data удаляет и их. Пункты 3–4 списка ниже относятся и к Windows.
macOS.
- Перетащите Pulse из «Программ» в корзину.
- Удалите данные, если они больше не нужны:
~/Library/Application Support/Pulse. - Worktree задач лежат внутри папки данных; если вы меняли «Папку worktree» в «Настройки → Общие», удалите и её.
- Ветки задач (
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 и публикация — в Разработке.