Waiting for a pull request review usually means refreshing GitHub or writing another polling loop. GitHub CLI now offers a cleaner option: wait for the event itself.
Announced on November 18, 2026, gh event listen uses GitHub Event Streams to watch a pull request and print incoming events as JSON. It is especially useful for local scripts and coding agents that need to resume when a reviewer responds.
Try the new command
First, install or upgrade to GitHub CLI 2.105.0 or later. You also need access to the Event Streams preview; it is not enabled for every GitHub account.
This example is from GitHub’s CLI documentation. Replace the example URL with your own pull request:
gh event listen --resource https://github.com/OWNER/REPO/pull/123 --event com.github.pull_request.review.submitted.v1 --timeout 30m
The command waits for a submitted review and normally exits after the first matching event. The --timeout 30m option prevents an unattended script from waiting forever.
What else can it watch?
- PR state: merged, closed, reopened or changed between draft and ready.
- New commits: changes to the pull request’s head branch.
- CI activity: a check suite completing, including its conclusion.
- Review activity: a reviewer submitting feedback.
For a longer-running listener, use --follow. For several events before exiting, use --count. The --jq option can extract specific fields from the JSON output.
The catch
This is a preview, not a universal replacement for polling. GitHub says Event Streams access is being granted through a waitlist, and the feature currently works on GitHub.com rather than GitHub Enterprise Server or GHE.com.
Events that occur before you connect—or while the stream is disconnected—are not replayed. After attaching, fetch the current pull request state so your automation does not miss an earlier change. A completed check suite also does not necessarily mean every CI check has finished.
Practical takeaway: if your account has preview access, use gh event listen to wake an agent on PR activity, then check the latest state before taking action.
