Heinzel — скилл

Heinzel превращает агента в осторожного администратора серверов по SSH: команды с пояснением и только после вашего одобрения.

  • 104 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • Агент выполняет команды на живых серверах с правами root или sudo.
  • Открытое SSH-соединение 10 минут доступно любому процессу вашего пользователя.
Все причины и проверки

wintermeyer/heinzel

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/heinzel

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент выполняет команды на живых серверах с правами root или sudo.
  • Открытое SSH-соединение 10 минут доступно любому процессу вашего пользователя.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Heinzel — набор правил и четырех скиллов, который превращает агента в осторожного системного администратора. Человек описывает задачу простым языком («Установи postgresql на server1.example.com»), агент определяет ОС, выбирает команды, объясняет каждую и ждет одобрения. Работают Linux, FreeBSD, NetBSD, OpenBSD и macOS, по SSH или на локальной машине. Скиллы: `heinzel-housekeeping` собирает отчет о диске, памяти, обновлениях, брандмауэре, сертификатах и упавших службах, `heinzel-security` проверяет SSH, брандмауэр, учетные записи и открытые порты по степени серьезности, `heinzel-email` отправляет вывод команд по почте, `heinzel-macos-cleanup` ищет остатки удаленных приложений. Каждый сервер получает папку памяти с состоянием, журналом изменений и списком дел. Конфиги перед правкой копируются в `/var/backups/heinzel/`.

Для кого. Администраторам и разработчикам, которые обслуживают свои серверы или Mac и хотят отдать агенту рутину, оставив за собой одобрение каждой команды.

Подходит, если

  • Нужен еженедельный отчет о сервере: диск, память, обновления, сертификаты, упавшие службы.
  • Сервер настроен давно, и надо проверить SSH, брандмауэр и открытые порты.
  • Службу ставят на машины с разными ОС, а команды сверяют с правилами платформы.
  • Работа прервалась, и следующий сеанс продолжает с записи состояния сервера.
  • На Mac копятся остатки удаленных приложений в `~/Library`.

Не подходит, если

  • Изменения надо выкатывать на много серверов волнами и по расписанию: этим занят коммерческий Heinzel Pro, а бесплатная версия идет по серверам по очереди.
  • Агент должен работать без одобрения команд: подтверждение составляет основу работы.
  • Рабочая станция на PowerShell или `cmd.exe`: они не поддерживаются, нужен WSL или Git Bash.

Пример запроса к агенту

Проверь сервер web1.example.com: отчет по диску, памяти, обновлениям и брандмауэру, без изменений.

Ограничения

Агент работает на живых системах от имени root или через sudo, поэтому каждую команду перед одобрением надо прочесть. Жесткую блокировку опасных операций (остановка машины, `mkfs`, запись в `sshd_config` и `sudoers`) делает хук для Claude Code. В OpenCode хук не запускается, и защитой остаются письменные правила. Для SSH нужен ключ без парольной фразы. Открытое соединение живет 10 минут, а сокет в `~/.cache/heinzel` доступен любому процессу вашего пользователя. Блокировка файлом `/etc/heinzel.conf` — обещание самого Heinzel, а не граница безопасности.

Как отключить. Удалите клонированную папку `heinzel`. Резервные копии конфигов лежат в `/var/backups/heinzel/` на серверах и стираются через 30 дней. Сокеты SSH в `~/.cache/heinzel` закрываются сами через 10 минут после последнего вызова.

Частые вопросы

Какие операции блокируются полностью?

Хук `guard-taboos.sh` в Claude Code блокирует остановку машины, `mkfs`, запись таблиц разделов и загрузчиков, удаление ключей SSH, запись в `sshd_config`, `sudoers` и файлы учетных записей, даже при `--dangerously-skip-permissions`. В OpenCode этого хука нет.

Где хранится память о серверах?

В папке `memory/servers/<hostname>/`: состояние, журнал изменений и список дел. Прерванная задача на следующем подключении отмечена как незавершенная.

Как защитить сервер от изменений?

Добавьте хост в `memory/readonly.md`: его только проверяют. Хосты из `memory/blacklist.md` не трогают вовсе. Владелец может записать `allow_changes = false` в `/etc/heinzel.conf` на самой машине.

Что делает откат при потере доступа?

Перед правкой, способной оборвать вход (адрес, маршрут, брандмауэр, VPN, PAM), на сервере запускается таймер на 120 секунд, который возвращает прежнее состояние. Новый вход по SSH останавливает таймер.

Чем бесплатный Heinzel отличается от Pro?

Бесплатная версия рассчитана на одного администратора, один терминал и серверы по очереди. Heinzel Pro ведет команду, веб-интерфейс, парк серверов и расписания.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Консольный SSH-инструмент для агентов: выполнение команд, загрузка и скачивание файлов, белые и черные списки команд.

CLIШирокий доступ88Звезды репозитория

Агент ведет установку macOS на обычный ПК с Windows по шагам: проверяет железо, готовит флешку и сохраняет Windows рядом.

СкиллШирокий доступ132Звезды репозитория

WebSSH-консоль для VPS с MCP-сервером: агент работает на нескольких серверах, а токены с ACL ограничивают инструменты и хосты.

MCP-серверШирокий доступ133Звезды репозитория

CLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP

CLIШирокий доступ356Звезды репозитория
Официальный

Скилл учит агента делить окно терминала Zentty на панели, читать соседние сессии, искать в истории и звать вас уведомлением

СкиллШирокий доступ331Звезды репозитория

HomelabHero за одну команду превращает свежий LXC в центр управления домашней лабораторией с Claude Code и брокером доступов.

CLIШирокий доступ105Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
Heinzel (эта карточка)нет104
SSH Skillнет561дает команды на серверах, передачу файлов и туннели с единым JSON-ответом; Heinzel добавляет одобрение, память по серверам и откат
cc-devops-skillsнет33931 скилл с генераторами конфигов и валидаторами для Terraform, Helm, CI и Docker; Heinzel ведет администрирование серверов с проверкой команд

Коротко о README

Репозиторий содержит правила по платформам, хук безопасности, скрипты `bin/heinzel-backup` и `bin/heinzel-update`, а также три видеоразбора на YouTube. Об инструменте писало немецкое издание heise.de.

Бейдж для README

Сообщить о проблеме