GitLab-pipelines in Claude: onze open source Claude Mod
Wie met Claude Code werkt, kent het ritueel: Claude schrijft de code, je doet een git push, en dan begint het wachten. Je opent een browsertab, zoekt het project in GitLab, klikt naar de pipeline en ververst tot alles groen is. Of rood.
Dat contextwisselen haalt je telkens uit je flow. Daarom heb ik de ci-pipeline-status gebouwd: een Claude Code mod die de voortgang van je GitLab CI-pipelines rechtstreeks in de statusregel van je sessie toont. Ze is open source, en vanaf vandaag kan iedereen ze gebruiken.

Je pipeline, zonder je sessie te verlaten
Na een git push zie je in de statusregel van Claude Code hoe je pipeline loopt, slaagt of faalt. Dat ziet er zo uit:
CI ● web-app ████████░░ 14/17 · ✓ api-service ██████████ 6/6
Per project krijg je een statussymbool, de projectnaam, een voortgangsbalk en het aantal afgewerkte jobs. Een afgelopen pipeline krijgt een ✓ als ze geslaagd is, een ✗ als ze faalde en een ⊘ als ze geannuleerd werd. Op dat moment verschijnt ook een melding in Claude Code en op je desktop, zodat je niet hoeft te blijven kijken.
Hoe het werkt
De mod start vanzelf. Na een geslaagde git push naar GitLab leest ze de To <host>:<project>.git-regel uit de push-output en begint ze die pipeline te volgen. Je hoeft niets te typen.
Enkele dingen die ik bewust zo ontworpen heb:
- Meerdere repositories tegelijk. De mod onthoudt elke repository die de sessie aanraakt: waar Claude bestanden bewerkt, of waar een commando met
cd <dir>ofgit -C <dir>draait. Werk je aan een frontend en een API tegelijk, dan zie je beide pipelines naast elkaar. - De juiste pipeline. De mod volgt de pipeline van je HEAD-commit, niet de laatste pipeline van de branch. Zolang GitLab die nog niet heeft aangemaakt, toont de statusregel
○ <project>. - Geen token in de mod. Alle communicatie met GitLab loopt via
glab, de officiële GitLab-CLI. De mod bewaart zelf geen enkel token. - gitlab.com én self-hosted. Met de omgevingsvariabele
GITLAB_HOSTvolg je ook pipelines op je eigen GitLab-server. Het is dezelfde variabele dieglabgebruikt, dus één instelling volstaat. - Zuinig. De mod pollt elke 10 seconden en stopt zodra alle pipelines klaar zijn. Komt er na 10 minuten geen pipeline, of enkel fouten, dan stopt ze voor dat project en zegt ze waarom.
Verder rekent de mod een downstream-pipeline als één job met de status van die pipeline, en tellen manuele jobs die nooit liepen niet mee in de voortgang.
Claude kan ook zelf een pipeline beginnen te volgen via de tool watch_pipeline. Vraag je Claude om te pushen en te controleren of de build slaagt, dan heeft het daar nu een eigen instrument voor.
Installeren in twee minuten
Je hebt Claude Code nodig met ondersteuning voor mods, en glab ingelogd op je GitLab-server. Log je in met een personal access token, dan volstaat de scope read_api.
brew install glab
glab auth login
Daarna installeer je de mod vanuit de Claude Code-prompt:
/plugin install ci-pipeline-status --marketplace ennovative-solutions/gitlab-pipeline-claude-mod
Antwoord y om de marketplace toe te voegen en kies een scope. In de desktop-app klik je op + naast het invoerveld, dan Plugins, en voeg je de marketplace ennovative-solutions/gitlab-pipeline-claude-mod toe.
Meestal hoef je daarna niets meer te doen. Wil je toch zelf sturen, dan is er het commando /pipeline:
| Commando | Wat het volgt |
|---|---|
/pipeline | De pipelines van alle repositories die deze sessie aanraakte |
/pipeline ../web-app | De pipeline van de HEAD-commit in die lokale map |
/pipeline <pipeline-URL> | Precies die ene pipeline |
/pipeline stop | Niets meer: de statusregel wordt leeggemaakt |
Dat laatste vangt ook het ene randgeval op: als de push-output geen To ...-regel bevat, start de watch niet vanzelf. Een /pipeline lost dat op.
Open source, en al te vinden in de mod-catalogi
De broncode staat onder MIT-licentie op GitHub. Voor GitHub Actions bestond al een mod die CI-status in de statusregel toont; voor GitLab-teams ontbrak die tot nu.
Je vindt de mod op deze plekken:
- GitHub: de broncode, issues en releases.
- Awesome Claude Code Mods van AI Dojo: daar is de mod opgenomen en gescand. Ze slaagt voor
claude plugin validateen de scan toont precies welke hooks en API-aanroepen ze gebruikt, zodat je vooraf weet wat ze kan. - ClaudeMod: de community-hub voor Claude Code-mods, skills en MCP-servers. Daar is de mod ingediend.
Ook de ontwikkeling zelf gebeurt in de open. Elke pull request doorloopt CI met JSON-validatie, een versiecheck, type-checking, de testsuite en een gitleaks-secretscan. De tests draaien tegen een nep-engine met fixtures, dus je hebt geen GitLab-account of netwerk nodig om bij te dragen.
Probeer het en laat van je horen
Werk je met Claude Code en GitLab? Installeer de mod, push iets, en kijk hoe je pipeline in je statusregel verschijnt. Geen tabbladen meer, geen refresh.
Heb je een idee, een bug of een verbetering? Issues en pull requests zijn welkom. En vind je de mod nuttig, geef het project dan een ster op GitHub: zo vinden ook andere GitLab-teams hun weg ernaartoe.