Я держу несколько сессий Codex в Herdr. Когда одна из них заканчивает задачу, мне всё равно нужно посмотреть изменения, проверить спорные места и вернуть замечания. Повторная самопроверка агента полезна, но моё ревью она не заменяет.
Чтобы не переносить замечания между окнами вручную, я сделал Herdr Hunk Review. Плагин связывает открытое в Hunk ревью с агентом и репозиторием, из которых оно было запущено.
Теперь процесс выглядит проще. Из панели агента я открываю Hunk, просматриваю изменения и оставляю комментарии. Ревью можно временно скрыть, не закрывая его и не теряя текущую позицию. Когда я заканчиваю, плагин собирает заметки и готовит из них черновик для того агента, с которого всё началось.
В этом и состоит результат. Дальше расскажу, почему для такой простой связи вообще понадобился отдельный плагин.
Какой ручной шаг я хотел убрать Link to heading
Для работы с агентами у меня уже был Herdr, а изменения я смотрел в Hunk. По отдельности оба инструмента решали свои задачи, но ничего не связывало открытую сессию Hunk с конкретной панелью Herdr.
Без плагина ревью превращалось в небольшой ритуал: открыть ещё одну панель в нужном репозитории, отдельно запустить Hunk, помнить, к какому агенту относятся эти изменения, а затем перенести комментарии обратно. Ни один шаг сам по себе не сложен. Просто их приходится повторять после каждого цикла, и при нескольких агентах появляется шанс выбрать не ту сессию.
Проблема была не в запуске Hunk. Мне не хватало сохранённой связи:
панель агента в Herdr <-> репозиторий Git <-> сессия Hunk
Два инструмента, два контекста Link to heading
Herdr знает, где работает агент Link to heading
Herdr — терминальный мультиплексор, который умеет распознавать кодинг-агентов. Codex, Claude Code, OpenCode и другие поддерживаемые консольные агенты остаются обычными процессами в терминале. Herdr группирует их по рабочим пространствам и вкладкам, позволяет делить экран и показывает состояние: кто работает, кто ждёт ответа, а кто уже закончил.
Можно закрыть клиент Herdr и позже вернуться к тем же процессам. У каждого обнаруженного агента при этом есть конкретная панель и рабочий каталог, к которым можно обратиться через командную строку. На этом интерфейсе и работает плагин.
Hunk связывает комментарий с кодом Link to heading
Hunk — инструмент для просмотра изменений в терминале. Он показывает все изменённые файлы, подсвечивает код и обновляет открытое ревью вслед за рабочей копией. Комментарии можно оставлять прямо рядом с изменениями, поэтому контекст замечания не теряется. Hunk не делает ревью за меня; он даёт нормальный интерфейс для чтения изменений целиком.
У Hunk уже есть режим работы с агентами и API для открытых сессий. Агент может читать текущее ревью, переходить к нужному фрагменту изменений и добавлять свои заметки. Мой плагин решает обратную задачу: забирает комментарии пользователя из Hunk и готовит из них черновик в исходной панели Herdr.
Что добавляет плагин Link to heading
Плагин открывает Hunk из контекста текущего агента и сохраняет связь между агентом, репозиторием и сессией ревью. Именно этой связи не было у двух отдельных инструментов.
Открытое ревью можно убрать с экрана и позже вернуть на прежнее место, не закрывая Hunk. Текущая позиция и сохранённые комментарии при этом остаются на месте.
После завершения ревью плагин использует сохранённую связь, чтобы подготовить промпт для исходного агента. При нескольких одновременных ревью для этого лучше находиться в нужной панели Hunk или агента. Плагин забирает только мои сохранённые комментарии, поэтому заметки агентов не смешиваются с моими. Незаконченные комментарии в промпт не попадают.
Как использовать комментарии Link to heading
Плагин не отправляет сообщение автоматически. Он вставляет в поле ввода исходного агента готовый черновик с комментариями, путями к файлам и положением изменённых фрагментов. Перед отправкой его можно проверить или отредактировать.
Встроенный шаблон просит агента сначала сверить каждое замечание с текущим кодом, объяснить неактуальные пункты, а после исправлений запустить подходящие проверки и кратко перечислить изменения. Формулировки шаблона можно настроить под себя.
Простое «исправь комментарии» быстро теряет смысл, если код успел измениться, пока я дочитывал ревью.
Как установить Link to heading
Плагину нужны Herdr 0.7.0 или новее, Hunk 0.17.6 или новее, Node.js 18+ и Git. Сейчас поддерживаются Linux и macOS.
Hunk можно установить через npm, затем добавить плагин из GitHub:
npm install --global hunkdiff
herdr plugin install quantk/herdr-hunk
После установки действия плагина можно назначить на любые свободные сочетания клавиш. Точная настройка и готовый запрос для установки с помощью Codex или другого агента есть в README плагина.
Границы первой версии Link to heading
Плагин пока находится на ранней стадии и связывает с агентом только ревью текущих изменений в рабочей копии. Сам Hunk умеет показывать коммиты и патчи, а также работать с Jujutsu и Sapling, но эти режимы плагин пока не выводит наружу.
Ревью нужно начинать из панели агента, распознанного Herdr, внутри репозитория Git. При нескольких ревью в одном рабочем пространстве лучше явно выбрать нужную панель Hunk или агента. Windows пока не поддерживается.
Плагин не меняет файлы, не коммитит код и не делает ревью за меня. Herdr по-прежнему управляет агентами и терминалами, Hunk показывает изменения, а между ними теперь не приходится переносить контекст руками.
Исходный код и инструкция по установке: github.com/quantk/herdr-hunk.