Устранение неполадок

Работает ли?

curl -s http://127.0.0.1:7788/healthz

Вы увидите: ok. Потом проверьте свою сборку и откройте дашборд на http://127.0.0.1:7788:

harnsy version
harnsy update --check

Журналы.

journalctl --user -u harnsy

ls ~/Library/Logs/harnsy/

~/.harnsy/logs/serve.log

Файл serve.log вмещает 10 МБ, плюс 3 старых файла.

Перезапустить harnsy.

systemctl --user restart harnsy.service

launchctl kickstart -k gui/$(id -u)/com.github.butschster.harnsy

Пять частых случаев

1. «harnsy: command not found» после установки. ~/.local/bin нет в вашем PATH. Установщик предупреждает об этом и не правит ваши профили оболочки. В Windows установщик добавляет свою папку в PATH пользователя; терминал, открытый раньше, нужно открыть заново.
2. Дашборд не открывается, healthz молчит. Служба остановлена. Проверьте её и журнал выше:
   ShellCopy

   systemctl --user status harnsy.service

   Сломанный config.yaml останавливает службу, а журнал называет файл, строку и ключ. Без пользовательского systemd установщик печатает, как запустить harnsy serve вручную.

3. Агенты не открываются. Терминал не выбран (terminal.driver не задан) или tmux нет, либо он старше 3.1. Поставьте tmux и задайте драйвер в ~/.harnsy/config.yaml (или используйте conpty), затем перезапустите:
   YAMLCopy

   terminal:
     driver: tmux

   Сообщения, команды и дашборд работают и без него; запуски сообщают no_terminal.

4. Агент не получает сообщения или не знает про harnsy. Хук сообщает только сессиям, начатым после установки. Дайте уже работающей сессии и каждому агенту OpenCode эту строку:
   Copy

   Read http://127.0.0.1:7788/llms.txt and use harnsy to communicate with the other agents.

   Агент OpenCode работает, только когда его запускает harnsy. Хуку нужно, чтобы ~/.claude или ~/.codex существовали во время установки.

5. Вопросы о разрешениях Claude Code не появляются на дашборде. Нет ответного хука (вы отказались при установке или использовали --no-answer-hook). Запустите установщик снова и ответьте «да». Щит подсказывает, где вы: янтарный — вы не выбрали, зелёный — проверки включены, красный — проверок нет.

Windows Security помечает harnsy.exe. Мы считаем это ложным срабатыванием; имя, которое показывает Windows Security, — Trojan:Win32/Gracing.I. Скачанное можно проверить самому, прежде чем что-то исключать. Скачайте zip harnsy_<версия>_windows_<amd64|arm64>.zip и SHA256SUMS с одной и той же страницы выпуска: github.com/harnesy/app/releases, страницы вашей версии. В PowerShell выполните:

Get-FileHash .\harnsy_<версия>_windows_<arch>.zip -Algorithm SHA256

Сравните Hash (заглавные и строчные буквы не важны) со строкой этого zip в SHA256SUMS. Считайте хеш zip, а не распакованного harnsy.exe и не установленного файла. Так файл сравнивается со списком из того же выпуска; это не доказывает, кто сделал выпуск. Если совпало, в Windows Security › Защита от вирусов и угроз › Управление настройками › Исключения › Добавить исключение › Папка добавьте %LOCALAPPDATA%\harnsy и запустите установщик снова.

Позже исключение можно убрать:

Remove-MpPreference -ExclusionPath "$env:LOCALAPPDATA\harnsy"

За корпоративным прокси. См. раздел о прокси в руководстве по установке и выполните harnsy net check.

Известные ограничения.

• Простаивающий терминал Codex не виден проверке, которая не даёт открыть сессию дважды, поэтому сессия Codex может открыться второй раз.
• Вопросы Codex приходят в конце его хода.
• Установка на macOS ещё не проверена на настоящем Mac.
• Релей harnsy — бета.