Когда автоматизация ждёт ревью или завершения проверок pull request, один из вариантов — периодически запрашивать его состояние. GitHub описал для CLI другой механизм: открыть поток событий и продолжить работу после получения нужного события. Это меняет способ ожидания, но не подтверждает, что такой подход надёжнее или быстрее опроса.
Чем событийное ожидание отличается от опроса
В публикации от 18 ноября 2026 года GitHub сообщил о поддержке GitHub Event Streams в GitHub CLI. Компания заявляет, что начиная с версии CLI 2.105.0 можно ждать изменения pull request одной командой, а не опрашивать его в цикле. Это описание назначения функции, а не результат сравнительного теста.
При polling клиент по расписанию запрашивает состояние и проверяет, произошло ли нужное изменение. В описанном GitHub варианте команда создаёт подписку, открывает поток и выводит поступившие события. Скрипт или агент может использовать вывод как сигнал для следующего шага, но само событие не задаёт, как именно на него реагировать.
Как работает gh event listen
Команда принимает URL pull request и список интересующих событий; каждое событие она печатает отдельной строкой JSON. По умолчанию команда завершается после первого события. Параметр --count позволяет ждать несколько событий, --follow — продолжать слушать, а --timeout — ограничить время ожидания. Для извлечения нужных полей GitHub указывает параметры --jq и --template.
На практике это даёт автоматизации точку ожидания с выбранным условием и структурированным выводом. Интерпретация JSON, обработка результата и решение о следующем действии остаются в логике скрипта или агента; публикация не описывает их за пользователя.
Какие события можно ждать и как это применить
GitHub перечисляет отправленные ревью, изменения состояния и head pull request, конфликты слияния и завершение наборов проверок. Отдельные команды позволяют создавать подписки, выводить их список, просматривать и удалять их. В том же объявлении GitHub сообщает, что команды gh pr create, gh pr view, gh run view, gh run watch и gh api предлагают gh event listen вместо polling.
Например, агент может после создания pull request ждать отправленного ревью, затем прочитать JSON и передать сведения в следующий этап обработки. Это сценарий, который можно собрать из описанных возможностей, а не опубликованная демонстрация успешно выполненного агентного цикла. Подсказки CLI также не означают, что агент автоматически меняет свою логику или корректно обрабатывает каждое событие.
Доступ и ограничения preview
Для начала работы GitHub указывает версию CLI 2.105.0 или новее и доступ к Event Streams. Команды gh event и Event Streams на GitHub.com находятся в предварительной версии и могут измениться; для получения доступа к потоку GitHub предлагает записаться в лист ожидания. Поэтому возможность нельзя считать доступной всем пользователям или стабильной заменой polling.
В объявлении нет независимых измерений задержки и надёжности доставки, сравнения нагрузки с polling или описания гарантий при разрыве соединения и пропуске события. Это не доказывает, что такие сбои происходят; это означает, что по публикации нельзя оценить поведение механизма в этих условиях. Команде, решающей, заменять ли опрос, сначала нужно учитывать режим preview и самостоятельно оценить пригодность инструмента для своего процесса.
Итак, gh event listen предлагает событийную точку ожидания для скриптов и агентных циклов, а параметры команды позволяют задать число событий, продолжительность слушания и извлечение полей. Объявление объясняет интерфейс и условия доступа, но не показывает сравнительных результатов, на которых можно было бы основывать вывод о скорости или надёжности.
Источник: GitHub Changelog — Wait for pull request events with GitHub CLI.








