Десктоп-коннектор

Приложение, которое кладёт бэклог на диск рядом с кодом. Задачи становятся markdown-файлами в репозитории, кодовый агент читает их как обычные файлы, а отчёт о сделанном уезжает обратно в бэклог.

Установка

Приложение для macOS на Apple Silicon, около 95 МБ, страница загрузки. Подписано Apple Developer ID и нотаризовано, поэтому открывается обычным двойным кликом — без терминала и без ручных разрешений в Настройках.

  1. Откройте скачанный .dmg.
  2. Перетащите ZERNO Connector в папку Applications.
  3. Запустите из Applications. При первом запуске macOS один раз спросит «Открыть?» — подтвердите.

Обновления ставятся сами в фоне: переустанавливать вручную и заново что-то разрешать не нужно.

Привязка репозитория

  1. Войдите через браузер — учётная запись та же, что на сайте.
  2. Выберите проект и локальную папку с кодом.
  3. Connector разложит задачи и инструкции рядом с кодом и дальше будет держать их в актуальном состоянии.

Что появляется в репозитории

ПутьЧто там
zerno/<статус>/<TASK>.mdОткрытые задачи по статусам: inbox, ready, in_progress, at_agent, review.
zerno/attachments/<TASK>/Вложения задачи.
zerno/reports/<TASK>.mdОтчёт агента о сделанной работе — его Connector загружает обратно.
zerno/triage/<TASK>.jsonПредложения по разбору бэклога: тип, размер, готовность, риск.
zerno/scores/<TASK>.jsonОценки важности, влияния и трудоёмкости.
Предложения агента не применяются молча
Разбор и оценки остаются предложениями, пока их не примет человек. Агент пишет файл, Connector его загружает, решение принимаете вы.

Инструкции для агентов

Кодовому агенту нужно знать, где лежат задачи и что с ними делать. Connector кладёт эти инструкции сам, каждому в его формате:

  • Codex — управляемый блок в AGENTS.md.
  • Claude Code — навык в репозитории.
  • OpenCode — навык и совместимый пакет в .opencode.

После этого работа выглядит как обычный разговор с агентом: «разбери бэклог», «возьми задачу ID318». Файлы он читает с диска, в сеть за ними не ходит.

Как это связано с остальным

  • Аудит. Стратегические главы отчёта считаются локально: сервер присылает рецепт, Connector выполняет его на вашей машине. Поэтому глубокая часть аудита появляется, когда приложение запущено.
  • MCP. Если агенту нужен доступ к задачам по сети, а не через файлы, это MCP-сервер — отдельная поверхность, коннектор для неё не нужен.
  • Расход на модели. Connector собирает статистику работы кодовых агентов, и она попадает в сводку по расходу в кабинете.

Если что-то не сходится

  • Задачи не появились — проверьте, что выбран правильный проект и папка, и что в проекте есть открытые задачи.
  • Отчёт не уехал — он загружается из zerno/reports/; файл должен называться по идентификатору задачи.
  • Приложение говорит про обновление по кругу — проверьте, что стоит последняя версия: повторная загрузка .dmg поверх текущей установки безопасна.

Скачать

Десктоп-коннектор — документация ZERNO