Если что-то пошло не так
Сверено с выпуском 0.36.0, 14.11.2026.
Быстрый способ помочь себе и нам: Настройки → Справка → Журнал и отчёт об ошибке. Там видно, где лежит журнал, можно посмотреть его хвост, описать, что случилось, и отправить отчёт разработчикам. В отчёт попадают версия, окружение и хвост журнала; ключи и токены маскируются.
Карточка ошибки с кодом `PULSE-…`
Ошибка в Pulse показывается карточкой: что случилось, почему, что сделать; сырой текст — под «Подробнее». У каждой
карточки есть код вида PULSE-AGENT-019 и кнопка «Справка» — она открывает статью этого кода без сети. Все статьи —
коды ошибок и Настройки → Справка.
Не получается войти
- «Войти через браузер» выключена с подписью «Вход через браузер появится после обновления сервера» — сервер Pulse ещё старый. Войдите по почте: кнопка «Войти по почте здесь · старый способ».
- Браузер не открылся — нажмите «Открыть браузер ещё раз» или скопируйте адрес из сообщения и откройте его сами.
- На сайте другой код запроса, чем в окне Pulse, — не подтверждайте вход: это чужой запрос.
- Почта или пароль не подошли, слишком много попыток — статьи PULSE-AUTH-002 и PULSE-AUTH-004.
Подробнее — Вход, лицензии и кабинет.
Расписание не запускается: «агент требует входа»
Агент расписания не вошёл в свой CLI. Запуск пропускается с этой причиной (видно в «История» расписания), а в «Требует внимания» стоит карточка агента со счётчиком пропусков. Нажмите «Войти» — откроется вход этого агента — или войдите в «Настройки → Агенты». Карточка уйдёт сама, когда Pulse увидит, что вход выполнен.
Связка ключей спрашивает пароль каждый раз
В связке ключей запись Pulse Safe Storage — ключ шифрования. Сами ключи API, токены
GitHub/GitLab и облачная сессия лежат в secrets.json в папке данных приложения
(где она). Запись из связки не удаляйте и не открывайте
её всем приложениям: без этого ключа уже записанный secrets.json не расшифровать.
«Разрешать всегда» macOS запоминает для подписи приложения, а не для имени Pulse и не
для номера версии. Согласие не переносится на другую подпись. Обычная сборка из исходников
(npm run pack) подписывается сертификатом «Pulse Dev», если он есть в связке, иначе
ad-hoc — и у ad-hoc у каждой сборки свой хэш кода. Выпущенный DMG может быть подписан
Developer ID; это не тот же сертификат, что «Pulse Dev», и по номеру версии сертификат не
виден. Одна и та же подпись между запусками согласие сохраняет. Код не обещает ни «один раз
навсегда», ни что запрос придёт ровно один раз после каждого обновления: новая сборка с той
же подписью может не спросить снова, сборка с другой подписью спросит как новое приложение.
Если запрос всё же на каждом запуске одной установленной копии, по номеру версии подпись не видна. Проверьте путь и список доступа, не ключ:
- Запускайте приложение из «Программ», а не из смонтированного DMG.
- В «Связке ключей» откройте Pulse Safe Storage → «Доступ» и убедитесь, что в списке этот Pulse. Запись не удаляйте и доступ всем приложениям не включайте.
- Свою сборку из исходников подписывайте одним сертификатом: один раз
scripts/make-signing-cert.sh. На уже выпущенный DMG это не действует.
Два Pulse в Launchpad
После сборки из исходников рядом с установленным приложением появляется распакованная копия
dist/mac-arm64/Pulse.app. Скрипт упаковки прячет её автоматически; если копия осталась —
удалите папку dist/mac-arm64.
Окно открылось пустым
Бывает при обрыве загрузки интерфейса. Pulse показывает экран загрузки и через несколько секунд предлагает «Перезапустить окно»; при падении процесса перезагружает сам. Если окно осталось пустым — закройте и откройте приложение, данные не пострадают.
«git не найден»
Pulse делает всё, что касается репозитория, настоящим git. Если его на машине нет, любая
операция — завести задачу, показать изменения, сделать коммит — сообщит об этом прямо и
назовёт, что поставить:
| Система | Что сделать |
|---|---|
| Windows | Поставить Git для Windows со страницы https://git-scm.com/download/win и запустить Pulse заново. По умолчанию git там не стоит ни в какой поставке. |
| macOS | xcode-select --install в Терминале — git приходит вместе с инструментами командной строки Xcode. |
| Ubuntu, Debian | sudo apt install git; в Fedora — sudo dnf install git. |
Git установлен, а Pulse его не видит — значит, он не в PATH (портативная установка,
нестандартный префикс, или установщик Windows не добавил его в переменную). Укажите полный
путь переменной окружения PULSE_GIT_PATH:
# Windows, PowerShell: для текущей учётной записи, один раз
[Environment]::SetEnvironmentVariable('PULSE_GIT_PATH', 'C:\PortableGit\cmd\git.exe', 'User')
# macOS и Linux: в ~/.zshrc или ~/.bashrc
export PULSE_GIT_PATH=/opt/git/bin/git
Приложение после этого нужно запустить заново — переменные окружения оно получает при старте.
В сборку можно положить свой git, тогда системный не понадобится вовсе: см. «Откуда берётся git».
Агент не подключается
- «не найден» — бинарника нет в
PATH. Укажите путь вручную в карточке агента или установите CLI. - «требуется вход» — нажмите «Войти» в карточке агента. У Claude Code вход — отдельный
OAuth-токен: выполните
claude setup-tokenв системном терминале и вставьте токен в поле «OAuth-токен Claude Code»; общую связку ключей и~/.claudePulse агенту не открывает. - Кнопка «Проверить снова» в списке агентов перепроверяет всех.
Агент не запускается: «граница чтения недоступна»
В «Спрашивать» и «Правках сами» процесс агента Pulse запускает только под системной границей чтения — агент видит рабочую копию задачи, а не весь дом (Контроль). Барьера нет — агент не запускается, а не идёт без защиты. Быстрый выход — «Полный доступ»: в нём агент идёт без границы, как ваш терминал. Иначе:
- Linux — нужен
bubblewrap(sudo apt install bubblewrap) и разрешённые пользовательские пространства имён; на Ubuntu 24.04 их может закрывать AppArmor. Причина — в журнале, строки «[песочница] …». - macOS —
sandbox-execесть в системе; если проба не прошла, причина тоже в журнале. - Windows — системной границы пока нет, и агенты на Windows не запускаются вовсе; терминал человека работает (Платформы).
Программы из домашних каталогов (~/.nvm, ~/.local/bin, ~/.cargo/bin) под границей не видны:
ставьте CLI агента в системный путь или Homebrew.
Агент ходит по кругу
С 0.34: три одинаковых вызова подряд с одинаковым итогом — Pulse сам останавливает ход и пишет об этом над полем ввода; «Продолжить» — если повтор был нужен.
Агент не выходит в сеть за корпоративным прокси
Окно Pulse ходит в сеть через Chromium и видит системный прокси само. Агенты — отдельные
программы (Claude Code, Codex, Kimi, OpenCode), и приложение, запущенное из Dock или меню
«Пуск», не передаёт им переменных вашей оболочки. Отсюда ошибки вида ECONNREFUSED,
ETIMEDOUT или self-signed certificate in certificate chain на первом же запросе агента.
Настройки → Сеть и приватность → «Сеть для агентов»:
- Прокси —
http://сервер:портилиhttp://логин:пароль@сервер:порт. Передаётся агентам и командам в их терминале какHTTPS_PROXY/HTTP_PROXY(и в нижнем регистре). Пароль хранится в настройках открытым текстом, как в самой переменной; в журнал и на экран адрес попадает со звёздочками вместо пароля. SOCKS не принимается: большинство CLI его черезHTTPS_PROXYне понимают. - Без прокси — исключения через запятую;
localhost,127.0.0.1и::1добавляются всегда, чтобы локальная модель и шлюз не уходили в прокси. - Системный прокси — если свой не задан, Pulse спрашивает Chromium
(
session.resolveProxyдляhttps://api.anthropic.com/) и передаёт ответ. PAC-файл вправе назначать разным адресам разные прокси: если у провайдера вашего агента прокси другой — задайте его явно. Прокси, с которым запущен сам Pulse (HTTPS_PROXYв его окружении), не переписывается: порождённые программы и так его наследуют. - Корневой сертификат (PEM) — путь к файлу; передаётся как
NODE_EXTRA_CA_CERTS. Это переменная Node.js: её читает Claude Code и адаптеры ACP, которые Pulse запускает на своём Node. Читают ли её сами Codex, Kimi и OpenCode, не проверено. Файл, которого нет или который не похож на PEM, не передаётся, и карточка говорит об этом словами.
Действует на агентов и терминалы, запущенные после изменения: у живого процесса окружение задано при запуске. Вкладкам терминала, которые открыли вы сами, прокси не передаётся — у вашей оболочки свой профиль. Встроенный агент с локальной моделью ходит в сеть через Chromium и системный прокси видит сам; GigaChat ходит своим клиентом (цепочка НУЦ Минцифры), и прокси из этих настроек ему не передаётся. MCP-серверам, которые Pulse запускает для встроенного агента, прокси тоже пока не передаётся.
Codex: «не найден» или новая модель недоступна
- CLI ставить не нужно: он встроен в Pulse, карточка показывает «встроенный CLI» и версию. Нужен вход — кнопка «Войти» (аккаунт ChatGPT) или ключ API OpenAI в той же карточке.
- Нужной модели нет в списке — в поле «Модель» карточки выберите «Другая модель…» и
впишите её id (например
gpt-6-astra). Если аккаунт к ней ещё не допущен, запрос вернёт ошибку доступа: это ограничение OpenAI, а не Pulse.
Локальная модель: «сервер не отвечает» или «моделей нет»
Нажмите «Проверить» в карточке — Pulse скажет, в чём дело:
| Что показывает | Что делать |
|---|---|
| сервер не отвечает | проверьте адрес и что сервер запущен (ollama serve, Local Server в LM Studio); если сервер за VPN — что туннель поднят |
| требует ключ | укажите ключ API сервера (LiteLLM, vLLM за прокси) |
| моделей нет | загрузите модель на сервере (ollama pull qwen2.5-coder) |
| инструменты: нет | модель не умеет function calling — возьмите qwen2.5-coder, qwen3, llama3.1, devstral, gpt-oss |
GigaChat
| Симптом | Причина и решение |
|---|---|
| «scope from db not fully includes consumed scope» | ключ выпущен под другой тип доступа. Pulse подбирает scope сам; если не помогло — проверьте, тот ли ключ из кабинета |
| 402 Payment Required | у аккаунта нет токенов для выбранной модели. В тариф может входить не каждая модель: выберите другую в чипе «Модель» или пополните пакет в личном кабинете |
| Отвечает текстом, но не пользуется инструментами | обновите Pulse до 0.22.7 или новее: там исправлены три несовместимости формата вызова функций |
| «не найден корневой сертификат НУЦ Минцифры» | в сборке из исходников — обновитесь; сертификат лежит в resources/certs |
Рой стоит на месте
- Посмотрите колонку сессий задачи (с роем она называется «Рой»): у кого задание «в работе», у кого отчёт.
- Задание без отчёта дольше 20 минут прерывается автоматически и уходит на повтор.
- Участник мог упасть — Pulse повторит задание дважды, потом сообщит архитектору.
- Если архитектор не раздал заданий, он, скорее всего, не оформил блок
pulse-assign— напишите ему в чат: «раздай задания блоком pulse-assign».
Обновление не приходит
Проверьте Настройки → Облако: включено ли облако и верный ли адрес. Ручной путь — скачать установщик со страницы https://pulse.avacloude.ru/download. Обновление ставится поверх, данные сохраняются. С версий до 0.31.10 обновиться можно только ручной установкой: ключ подписи выпусков сменился.
Задача сломала репозиторий
Каждая задача работает в своём worktree на отдельной ветке, основной клон не трогается.
Удалите задачу (worktree и ветка уйдут вместе с ней) или откатите ветку обычными командами
git. Раздел Worktrees (⌘ 3) показывает все рабочие копии и позволяет убрать осиротевшие.
Испортил последний ход агента — его можно откатить в самой сессии: «Откатить ход» с выбором
«Файлы и беседа», «Только файлы» или «Только беседа». Pulse снимает копию задачи перед каждым ходом
(до 30 ходов на сессию) в своё хранилище, вне .git; после отката есть «Вернуть как было».
Куда смотреть ещё
- Дашборд → Активность — что происходило: ходы, ошибки, разрешения, обслуживание. Есть поиск, фильтры по виду и задаче, периоды.
- Журнал —
logs/pulse.logв папке данных: полная техническая картина. - Аудит задачи — кнопка в шапке задачи: кто что запускал и какие разрешения выдавались.