Установка

Полная страница — Установка; здесь краткая версия.

Что нужно заранее. Должна быть установлена хотя бы одна AI-программа: Claude Code, Codex или OpenCode. В Claude Code или Codex вы входите при первом запуске (страница 2); агент OpenCode работает, когда его запускает harnsy. Для терминалов harnsy использует tmux или собственный встроенный терминал (ставить ничего не нужно; Windows 10 1809 и новее). Установщик предложит один из них. Без них сообщения, команды и дашборд работают, но агентов harnsy сам не открывает.

Шаги

1. Сначала посмотрите план, ничего не меняя.

curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

$env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

Вы увидите: каждый шаг и каждый diff, которые сделает установщик. Ничего не записывается.

2. Установите. Выполните ту же команду без --dry-run.

curl -fsSL https://harnsy.dev/install.sh | sh

irm https://harnsy.dev/install.ps1 | iex

harnsy ставится в ~/.local/bin (Windows: %LOCALAPPDATA%\harnsy\bin) и запускается как пользовательская служба. Загрузка сверяется с SHA256SUMS выпуска.

3. Ответьте на вопросы установщика в терминале. Он спрашивает перед каждым изменением ваших собственных файлов: выбор терминала, значок в трее (и запуск при входе), хук-справка и хук-ответ для Claude Code и Codex, записи «разрешить harnsy» для авторежима Claude Code, строка состояния Claude. Каждое изменение показывается как diff, ваше «да» запоминается для следующей установки.

curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run

$env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex

4. Проверьте, что он работает.

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

Вы увидите: ok. Потом откройте http://127.0.0.1:7788 в браузере.

Обновление

harnsy сам обновления не проверяет. Проверьте и обновите:

harnsy update --check
harnsy update

В дашборде то же делают кнопки «Проверить обновления» и «Обновить». Подойдёт и повторная команда установки. Ваши данные в ~/.harnsy остаются. Узел перезапускается на несколько секунд, сессии агентов продолжают работать.

Вернуться назад

После обновления:

harnsy update --rollback --yes

Или поставьте старый выпуск поверх нового (переменная идёт в sh, а не в curl):

curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<тег> sh -s -- --allow-older

Отмена

harnsy uninstall --dry-run
harnsy uninstall

Команда убирает службу, значок в трее, программу и только те записи в настройках, которые добавила сама установка (хуки, записи авторежима, строку состояния; ваша строка возвращается, если установка её обернула), показав diff и спросив.