Десктоп-коннектор
Приложение, которое кладёт бэклог на диск рядом с кодом. Задачи становятся markdown-файлами в репозитории, кодовый агент читает их как обычные файлы, а отчёт о сделанном уезжает обратно в бэклог.
Установка
Приложение для macOS на Apple Silicon, около 95 МБ, страница загрузки. Подписано Apple Developer ID и нотаризовано, поэтому открывается обычным двойным кликом — без терминала и без ручных разрешений в Настройках.
- Откройте скачанный
.dmg. - Перетащите ZERNO Connector в папку Applications.
- Запустите из Applications. При первом запуске macOS один раз спросит «Открыть?» — подтвердите.
Обновления ставятся сами в фоне: переустанавливать вручную и заново что-то разрешать не нужно.
Привязка репозитория
- Войдите через браузер — учётная запись та же, что на сайте.
- Выберите проект и локальную папку с кодом.
- 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 кладёт эти инструкции сам, каждому в его формате:
- Codex — управляемый блок в
AGENTS.md. - Claude Code — навык в репозитории.
- OpenCode — навык и совместимый пакет в
.opencode.
После этого работа выглядит как обычный разговор с агентом: «разбери бэклог», «возьми задачу ID318». Файлы он читает с диска, в сеть за ними не ходит.
Как это связано с остальным
- Аудит. Стратегические главы отчёта считаются локально: сервер присылает рецепт, Connector выполняет его на вашей машине. Поэтому глубокая часть аудита появляется, когда приложение запущено.
- MCP. Если агенту нужен доступ к задачам по сети, а не через файлы, это MCP-сервер — отдельная поверхность, коннектор для неё не нужен.
- Расход на модели. Connector собирает статистику работы кодовых агентов, и она попадает в сводку по расходу в кабинете.
Если что-то не сходится
- Задачи не появились — проверьте, что выбран правильный проект и папка, и что в проекте есть открытые задачи.
- Отчёт не уехал — он загружается из
zerno/reports/; файл должен называться по идентификатору задачи. - Приложение говорит про обновление по кругу — проверьте, что стоит последняя версия: повторная загрузка
.dmgповерх текущей установки безопасна.
