Hoe kan een agent weten dat er een nieuwe review op een pull request is verschenen, zonder GitHub elke minuut te raadplegen en zonder dat de gebruiker een publieke server nodig heeft? Op 17 november 2026 opende GitHub Event Streams als preview: een client abonneert zich op een pull request, houdt de verbinding met GitHub open en ontvangt gebeurtenissen zodra ze plaatsvinden.

De praktische verandering is relevant voor lokale agents en automatiseringen die moeten reageren op updates van een repository. Zonder eigen webhookontvanger is periodiek pollen van de API de gebruikelijke manier om veranderingen te volgen: frequente verzoeken verbruiken het quotum, terwijl zeldzame controles de reactie vertragen. Met een eventstream kan de verwerking starten zodra er een wijziging wordt gemeld, in plaats van op basis van een timer.
Welke gebeurtenissen een abonnee ontvangt
De documentatie van Event Streams vermeldt gebeurtenissen voor pull requests: een review indienen, een nieuwe commit, een mergeconflict, het samenvoegen of sluiten van een aanvraag, en wijzigingen in de set controles of het voltooien van een afzonderlijke controle. De gebeurtenissen worden verzonden via Server-Sent Events (SSE); een publieke webhookendpoint is niet nodig voor de client. Dit is bijvoorbeeld geschikt voor een agent op de laptop van een ontwikkelaar die moet reageren op een nieuwe review of commit.
Een gebeurtenis geeft een wijziging aan; vervolgens haalt de client de actuele gegevens op via de GitHub REST API. Een melding over een nieuwe review verwijst bijvoorbeeld naar de bijbehorende API-resource. Via die resource kan de client de actuele staat van de review of pull request ophalen voordat de volgende actie wordt gestart.
Hoe een stream verschilt van polling en webhooks
Polling is eenvoudig: de client verstuurt met een vast interval verzoeken en vergelijkt de antwoorden. Het interval vormt een compromis tussen vertraging en het aantal verzoeken: bij een controle elke minuut kan een reactie wachten tot de volgende cyclus, terwijl frequentere controles veel verzoeken kunnen opleveren zonder dat er iets is veranderd. GitHub noemt precies deze afweging als reden voor een eventgestuurde optie.

Bij Event Streams maakt de client eenmalig een abonnement op een pull request aan, maakt verbinding met GitHub en wacht via de open verbinding op gebeurtenissen. Een webhook stuurt ook gebeurtenissen door, maar daarvoor heeft een integratie doorgaans een publiek bereikbare ontvangende endpoint nodig. Daarom is een stream handig voor een interactieve client of lokale agent, terwijl een webhook geschikt is voor een service die al inkomende verzoeken ontvangt. Polling blijft een begrijpelijke keuze voor controles die zelden nodig zijn en waarbij een snelle reactie niet belangrijk is.
Een andere praktische consequentie is dat het abonnement op een specifieke resource is gericht. De GitHub-documentatie beschrijft een route om je op één pull request te abonneren, niet een universele feed met alle updates van een repository. Ontwerp de handler daarom rond een specifieke pull request en de gebeurtenistypen die daarvoor nodig zijn.
Hoe een lokale agent kan werken
Stel je een agent voor die helpt bij het beoordelen van een pull request. Bij een reviewgebeurtenis haalt de agent de actuele gegevens op en kan die een analyse van de opmerkingen voorbereiden; na een nieuwe commit kan de agent de controles opnieuw uitvoeren; na het sluiten of samenvoegen kan de bijbehorende taak worden afgerond. Dit is een toepassingsvoorbeeld op basis van de door GitHub genoemde gebeurtenistypen, geen door het bedrijf gepubliceerd testresultaat van dit scenario.
De volgorde is belangrijk: de gebeurtenis meldt dat er iets is veranderd, waarna de client de actuele status ophaalt via de vermelde API-resource. Omdat gebeurtenissen herhaald kunnen worden of niet altijd in de juiste volgorde binnenkomen, moet een handler herhaalde bezorging veilig kunnen verwerken en de status via de API controleren. Ga er niet van uit dat de volgorde van meldingen een volledige geschiedenis van de wijzigingen vormt.
Met welke beperkingen je rekening moet houden
Op 18 november 2026 is Event Streams beschikbaar als preview op alle GitHub-abonnementen, na goedkeuring van een aanvraag via de wachtlijst. De toegang wordt per account ingeschakeld en is dus niet automatisch beschikbaar voor iedere gebruiker. De documentatie vermeldt ook dat de functie beschikbaar is op GitHub.com, maar voorlopig niet op GHE.com.
Een abonnement geldt voor één pull request en verloopt 24 uur na aanmaak. De stream speelt geen gebeurtenissen opnieuw af die plaatsvonden vóór de verbinding, in de korte periode na het aanmaken van het abonnement of tijdens een verbroken verbinding. GitHub raadt aan om na het abonneren eenmaal de actuele status van de pull request op te halen en bij herhaalde of niet op volgorde binnengekomen gebeurtenissen op de API-gegevens te vertrouwen. In de praktijk betekent dit dat een agent ondersteuning nodig heeft voor opnieuw verbinden en statuscontrole, niet alleen een open verbinding.
In de preview zijn pull-requestgebeurtenissen beschikbaar. De documentatie beschrijft de huidige set en vermeldt dat de API, gebeurtenistypen en limieten kunnen veranderen. Als een automatisering andere repositorygebeurtenissen of gegarandeerde serverbezorging nodig heeft, controleer dan of de stream daarin voorziet. Zo niet, gebruik dan een webhook of controleer de API.
Voor een lokale agent die zonder publieke server op pull-requestgebeurtenissen moet reageren, biedt Event Streams een direct eventkanaal in plaats van frequente verzoeken. Daar staat tegenover dat het abonnement tijdelijk is en één pull request omvat, en dat de actuele status na gemiste gebeurtenissen moet worden hersteld. Voor controles die zelden nodig zijn, is polling handiger; bouw serverintegraties rond webhooks als bezorging naar een eigen endpoint nodig is.