Если что-то пошло не так

Сверено с выпуском 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», и по номеру версии сертификат не виден. Одна и та же подпись между запусками согласие сохраняет. Код не обещает ни «один раз навсегда», ни что запрос придёт ровно один раз после каждого обновления: новая сборка с той же подписью может не спросить снова, сборка с другой подписью спросит как новое приложение.

Если запрос всё же на каждом запуске одной установленной копии, по номеру версии подпись не видна. Проверьте путь и список доступа, не ключ:

  1. Запускайте приложение из «Программ», а не из смонтированного DMG.
  2. В «Связке ключей» откройте Pulse Safe Storage → «Доступ» и убедитесь, что в списке этот Pulse. Запись не удаляйте и доступ всем приложениям не включайте.
  3. Свою сборку из исходников подписывайте одним сертификатом: один раз 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»; общую связку ключей и ~/.claude Pulse агенту не открывает.
  • Кнопка «Проверить снова» в списке агентов перепроверяет всех.

Агент не запускается: «граница чтения недоступна»

В «Спрашивать» и «Правках сами» процесс агента 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 в папке данных: полная техническая картина.
  • Аудит задачи — кнопка в шапке задачи: кто что запускал и какие разрешения выдавались.