Buggazi + Claude Code

Projectmanagement voor coding agents. Net zo makkelijk als git. Klaar in 30 seconden.

Stap 1: Installeren + aanmelden

npm install -g buggazi
bgz signup my-project --local

Je API key wordt opgeslagen in .bgz/config.json in je project. De key is meteen ACTIEF met volledige toegang gedurende 48 uur. Begin direct met het melden van bugs en features, zonder kaart of e-mail vooraf. Voordat het venster sluit, opent je mens de proeflink ($0 kaartverificatie) om de gratis proefperiode van 7 dagen te starten; dezelfde key blijft werken en je gegevens blijven bewaard, geen nieuwe registratie.

Heb je al een key? Gebruik gewoon: bgz login --local --key YOUR_KEY

Doorverwezen door een Buggazi-gebruiker? Voeg --ref BGZ-REF-XXXX toe aan signup: 14 dagen proefperiode in plaats van 7.

Geen --api-url nodig. Standaard: buggazi.ai.

Stap 2: Voeg toe aan CLAUDE.md

Voeg dit toe aan het CLAUDE.md-bestand van je project zodat Claude Code Buggazi gebruikt:

Kopieer## Buggazi
Dit project gebruikt Buggazi voor bug-tracking en feature-planning.
Gebruik de `bgz` CLI. Config staat in .bgz/config.json (automatisch geladen).
Niet geconfigureerd: bgz login --local --key JOUW_KEY

Voer `bgz init --agent-schema` uit — het geeft elk commando + geldige flags.
Dat is de bron van waarheid: wat niet in het schema staat, niet gebruiken.

Stap 3 (aanbevolen): Installeer de schema-gate-hooks

bgz init --claude-hooks

Alleen voor Claude Code. Schrijft twee hook-scripts naar .claude/ en registreert ze in .claude/settings.json (je bestaande hooks blijven behouden; Claude Code vraagt je bij de eerste start om de project-hooks goed te keuren):

SessionStart ververst het live agent-schema en herinnert de agent eraan dat dit project zijn werk in Buggazi bijhoudt. PreToolUse valideert elk bgz-commando tegen dat schema voordat het draait: een verzonnen verb of subcommando wordt geblokkeerd met een foutmelding die het juiste commando noemt, zodat de agent zichzelf in dezelfde beurt corrigeert in plaats van een mislukte run te verspillen. Rauwe curl-writes naar de Buggazi-API worden omgeleid naar de CLI of de remote MCP.

Fail-open by design: als bgz of het schemabestand niet beschikbaar is, gaat alles gewoon door en wordt je sessie nooit geblokkeerd. --print toont een preview zonder iets te schrijven, --force regenereert over je aangepaste kopieen heen.

Stap 4: Aan de slag

Vraag Claude Code om wat dan ook — het ontdekt de commando's via bgz init --agent-schema en maakt bugs, features en sprints automatisch aan. Voeg --project KEY toe om werk per project te groeperen (onbekende keys maken het project automatisch aan, onbeperkt in elk plan).

Verder gaan: dispatch naar GitHub

Buggazi is het duurzame archief; GitHub-issues en PRs zijn wegwerpbare uitvoeringsartefacten. Je kunt een bgz-bug dispatchen als een GitHub-issue dat Claude Code in GitHub Actions oproept: de agent opent een PR, jij spiegelt de PR-status terug op het bgz-item, verifieert lokaal, merget en lost daarna op in bgz. Alleen backend/logic/api-items gaan headless; visueel werk blijft bij menselijke ogen. Het volledige patroon (routering, polling, workflow-limieten, subscription-auth) staat in llms.txt onder "GitHub Bridge".