PR-Agent aansluiten: de GitHub Action, de modelsleutel en wat het aan tokens kost

De vraag die deze pagina beantwoordt, is niet wat een PR-agent is — dat is een ander artikel — maar wat er gebeurt tussen het moment waarop je besluit dat je PR-Agent op je repository wilt en het moment waarop het een pull request beoordeelt. Het gat tussen die twee punten is ongeveer één YAML-bestand en één modelsleutel, en de onderdelen die mensen verkeerd doen, zijn precies degene die niemand documenteert: welk installatiepad actueel is, wat het standaardmodel per beoordeling kost, en waarom één enkele pull request je tien keer kan factureren.

PR-Agent is de open-source tool die CodiumAI heeft gebouwd en later aan de community heeft gedoneerd. Het is nu ondergebracht in een eigen GitHub-organisatie als een door de community onderhouden legacyproject van Qodo, onder MIT-licentie, met ongeveer 12,6k sterren en 1,7k forks. Het is gratis; de modelaanroepen die het doet zijn dat niet, en dat is het enige getal in deze opzet dat meeschaalt met je team.

De drie installatieroutes, en welke je eigenlijk wilt

• De GitHub Action — een workflowbestand dat dit uitvoert: code>the-pr-agent/pr-agent@main/code> bij pull-requestgebeurtenissen. Dit is het aanbevolen pad en het startpunt: het vereist geen server, geen webhook-eindpunt en geen geheim naast de modelsleutel en het token dat GitHub de action al geeft.

• De CLI — code>pip install pr-agent/code>, daarna code>pr-agent --pr_url <url> review/code>. Handig om een review op een bestaande PR uit te proberen voordat je iets aansluit, en om dezelfde engine te draaien vanaf een laptop of vanuit een CI-job die geen GitHub Actions is.

• De container en de webhook — de Docker-image, of het gehoste webhookpad voor GitLab, Bitbucket, Azure DevOps en Gitea. Kies dit wanneer je repositories niet op GitHub staan, of wanneer je de review wilt laten draaien binnen je eigen netwerkgrens.

Eén waarschuwing die je moet kennen voordat je een versienummer uit een tutorial overneemt: de eigen documentatie van het project vermeldt dat het gepubliceerde code>pip/code>-pakket momenteel achterloopt op de nieuwste release, en verwijst gebruikers naar een installatie via een GitHub-tag als ze de nieuwste code nodig hebben. Dat is een probleem van de stabiele toestand, geen incident, maar het betekent wel dat "de documentatie zei me pip install te doen" en "ik heb de huidige release" niet dezelfde zin zijn.

De modelsleutel is de daadwerkelijke beslissing.

PR-Agent wordt geleverd met modelondersteuning die bewust open is. In de release notes staat GPT-5.6 als de nieuwe standaard, met ondersteuning voor Gemini 3.6 en de families Claude Opus 5 en Claude Sonnet 5, terwijl DeepSeek en Mistral via hetzelfde configuratieblok werken. Welk model je ook kiest, jij levert de sleutel en de review draait op jouw account.

Dat is de open-sourceafweging in één zin: jij bezit de infrastructuur — sleutels, secrets, uptime en de rekening — in ruil voor kosten per review die niets met seats te maken hebben. Een team van vijf ontwikkelaars op een gehoste tool met prijs per seat betaalt hetzelfde, of het nu tien pull requests per maand mergeet of duizend. Bij de tokengeprijsde route volgt het bedrag wat je daadwerkelijk reviewt, wat beter is als je het druk hebt en slechter als je dat niet hebt.

Twee configuratiekeuzes beïnvloeden dat getal sterker dan de keuze van het model.

• Eén keer per pull request, niet één keer per push. Sommige tools reviewen standaard elke commit. Een PR met tien pushes wordt tien reviewruns, tien modelaanroepen en tien keer de rekening, voor negen reviews van code die niet meer bestaat. Controleer deze instelling eerst, waar je ook deployt.

• Beperk de diff.Al deze tools comprimeren de diff voordat die het model bereikt, omdat een wijziging van 2.000 regels niet in een prompt past met ruimte om na te denken. De PR-compressiestrategie van PR-Agent is de canonieke implementatie. Een gegenereerd bestand, een lockfile of een vendored dependency kan de diff en de kosten domineren zonder iets te bevatten dat een reviewer zou lezen — sluit ze uit.

Wat de commando's doen, en wat elk ervan kost

Eenmaal geïnstalleerd reageert de tool op slash-opdrachten in de pull request. Elke opdracht is doorgaans één modelaanroep, daarom komen antwoorden binnen tientallen seconden binnen en kosten ze fracties van een cent:

• code>/describe/code> — schrijft de PR-titel, samenvatting, walkthrough en labels uitsluitend op basis van de diff.

• code>/review/code> — scant op bugs, beveiligingsproblemen en onderhoudbaarheidsproblemen, met ernstlabels en een score.

• code>/improve/code> — stelt codewijzigingen voor die kunnen worden gecommit, in plaats van commentaar.

• code>/ask — beantwoordt een vraag op basis van de diff; dit is het commando dat reviewers het meest gebruiken zodra ze de tool vertrouwen.

• code>/update_changelog/code> — genereert het changelog-item voor de pull request opnieuw.

Het automatische gedrag dat de meeste teams willen, is één enkele code>/review/code> bij het openen van een pull request. Al het overige kan aan een opmerking worden overgelaten, wat de kosten voorspelbaar houdt en de agent uit de weg houdt van een reviewer die al aan het lezen is.

De faalwijzen waar niemand je voor waarschuwt

• De actie slaagt en plaatst niets. Meestal is het een rechtenprobleem: het workflowtoken kan de diff lezen maar geen opmerking schrijven. Controleer in het logboek van de actie op een 403 bij de aanroep om een opmerking te plaatsen voordat je het model debugt.

• Het beoordeelt de verkeerde diff. Fork-pull requests worden standaard uitgevoerd met een beperkt token, en een workflow die daarvoor niet is geconfigureerd, beoordeelt een lege of gedeeltelijke diff en rapporteert geen bevindingen. Stilte is geen schone lei.

• De review is zelfverzekerd en onjuist. Elke door een model ondersteunde reviewer zal af en toe code beschrijven die niet in de diff staat. De mitigatie is structureel in plaats van op promptniveau: vereis dat de tool de regels citeert waarover hij klaagt, en behandel een bevinding zonder citering als een opmerking in plaats van als een poort.

• Kosten sluipen binnen. Niet door een prijswijziging, maar door scope: meer repositories, meer pushes per PR, grotere diffs. Stel een maandbudget in op de sleutel die je hiervoor hebt uitgegeven, en beschouw de melding als het signaal dat er iets is veranderd in je workflow en niet in het model.

Waar een router past, en waar niet

Een PR-agent is een van de weinige AI-workloads waarbij het tussentijds wisselen van model echt nuttig is: de goedkope eerste pass vangt opmaak en duidelijke fouten, en alleen de pull requests die dat overleven, hebben een duur model nodig. Dat is precies de vorm die OrcaRouter's OrcaCode Review-product implementeert — een snelle pass van een goedkoop frontiermodel, escalatie naar een sterker model wanneer de screening iets vindt — en het is ook iets dat je zelf kunt benaderen met PR-Agent door de configuratie naar een gateway te wijzen en te routeren op PR-grootte.

Wat een router niet doet, is de review correct maken. De waarde zit in één sleutel voor elk model dat je zou willen vergelijken, de lijstprijs van de provider zonder opslag erbovenop, en failover wanneer een provider een slechte middag heeft midden in je mergewachtrij. Claude Opus 5.5 en Claude Sonnet 5.5, GPT-5.6 en de Gemini-lijn zijn allemaal aanroepbaar via hetzelfde OpenAI-compatibele endpoint, waardoor "welk model reviewt onze code" een configuratiewijziging is in plaats van een inkooptraject.

Wat te doen deze week

• Installeer de GitHub Action op {{1}}één repository{{/1}}, niet op {{2}}alle repositories{{/2}}. Eén repository vertelt je de reviewkwaliteit en de kosten per PR; alle repositories vertellen je beide zaken gedeeld door een ongemeten noemer.

• Beslis het model op basis van meting, niet op basis van reputatie. Voer code>/review/code> uit op je laatste twintig samengevoegde pull requests met twee verschillende modellen en vergelijk de bevindingen waar een mens mee instemde. Dat getal is de enige benchmark die hier telt.

Stel "eens per pull request" in voordat je iets anders instelt, en stel een budget in voor de sleutel.

• Behoud de menselijke controle. Een PR-agent die merges blokkeert, is een PR-agent die je team binnen een maand weet te omzeilen.

Bronvermelding: de herkomst, licentie, het aantal sterren, de installatiepaden, de commandoset en de standaardmodellen van PR-Agent, plus de opmerking dat het pip-pakket achterloopt op de nieuwste release, zijn afkomstig uit de repository en documentatie van het project zoals gelezen op 4 november 2026. De prijzen per seat en per credit van gehoste alternatieven zijn afkomstig van de gepubliceerde pagina's van die leveranciers en worden uitsluitend ter contrast vermeld. Grok en modelnamen worden gebruikt als configuratievoorbeelden; de modelidentificatoren op de gateway van OrcaRouter zijn op dezelfde datum gecontroleerd aan de hand van de actuele modellenlijst. De faalmodi zijn gebaseerd op hoe deze tools zich gedragen wanneer het workflowtoken te beperkte rechten heeft, niet op een specifiek incidentrapport.