GitHub CLI 新增 Event Streams 支持,可通过单一命令监听 PR 事件
Wait for pull request events with GitHub CLI
GitHub CLI 在 gh v2.105.0 版本中支持 GitHub Event Streams,开发者与 AI 智能体可通过 gh event listen 命令直接监听 Pull Request 状态变化,无需循环轮询。
该功能用事件流监听替代低效的循环轮询,便于开发者和智能体以更低开销捕获代码审查与状态变更。

GitHub CLI 现已支持 GitHub Event Streams。从 gh v2.105.0 开始,你和你的智能体只需一条命令就能等待 Pull Request 状态变更,无需再写循环反复轮询。
运行 gh event listen 时指定 PR 的 URL 以及你关注的事件(例如已提交的审查意见),它就会创建订阅、开启事件流,并将每个事件以单行 JSON 的格式输出。
- 该命令默认在收到第一个事件后就会退出,非常适合嵌入脚本和智能体的工作循环中。
- 使用
--count可等待多个事件,用--follow可保持持续监听,用--timeout则能停止等待。 - 你还可以配合
--jq或--template,只提取需要的字段。
你可以等待的事件包括:已提交的审查意见、PR 状态与 Head 分支变更、合并冲突以及已完成的检查套件(Check Suites)。如果想直接管理订阅,可以使用 gh event subscription create、list、view 和 delete。
智能体也能自行探索并使用这些新命令:gh pr create、gh pr view、gh run view、gh run watch 和 gh api 现在都会建议使用 gh event listen,而不是去循环轮询。
可用情况
gh event 系列命令目前处于预览阶段,后续可能会有调整。这些命令需要使用 GitHub.com 同样处于预览状态的 Event Streams 功能。如需获取权限,请申请加入 Event Streams 候补名单。
想要上手体验,请升级到 gh v2.105.0 或更高版本。详情请参阅 gh event 手册和 Event Streams 文档,或直接运行 gh event --help。
欢迎在 GitHub Community 讨论区留下你的反馈。
文章《Wait for pull request events with GitHub CLI》最初发布于 The GitHub Blog。
来源:GitHub Changelog · github.blog