Van foutmelding naar pull request.
Een bezoeker meldt een fout op je WordPress-site. Claude Code pakt de melding op, maakt de fix en zet een pull request voor je klaar. Jij beoordeelt en voegt samen. Gratis en open source.
- Versie
- 1.0.1
- Licentie
- GPL-2.0 of later
- Onderdelen
- WordPress-plugin en agent
- Afhankelijkheden
- Geen externe pakketten
Hoe het werkt
Drie stappen, zonder dat jij ertussen zit.
- Iemand meldt een foutVia de knop in de adminbalk of met Ctrl+Shift+F. De pagina, de browser, de schermgrootte en de taal gaan automatisch mee.
- De agent pakt het opEen script op je eigen machine haalt nieuwe meldingen op via de REST-API en geeft ze met alle context aan Claude Code.
- De pull request staat klaarClaude Code maakt de fix. De agent maakt een branch, commit en opent een pull request op GitHub.
Het idee komt van Joost de Valk, die zo'n pijplijn beschreef voor Rondo Club. FalconDebugger is mijn uitwerking ervan voor WordPress.
Wat het kan
Gemaakt voor sites die echt draaien.
- Meldknop
- Soort fout, prioriteit, titel en beschrijving, plus alles wat de browser zelf weet. Je bepaalt per rol wie de knop ziet.
- Multisite
- Netwerkbreed activeren: de knop staat op elke subsite, de meldingen komen centraal binnen met de site erbij.
- Meertalig
- Werkt samen met Polylang en WPML en legt de taal van de pagina vast. Zonder die plugins werkt het net zo.
- Beveiliging
- API-sleutels worden gehasht opgeslagen en maar één keer getoond. Met een limiet per uur, een lijst met toegestane IP-adressen en nonces.
- GitHub
- Branch, pull request met een nette beschrijving en desgewenst automatisch samenvoegen. Alles via de
gh-CLI. - Zelf plannen
- Eén keer draaien, of elk half uur via launchd op macOS of cron op Linux.
REST-API
Zes endpoints.
Alles behalve /health vraagt de header X-Falcon-Key.
| Methode | Route | Wat het doet |
|---|---|---|
GET | /falcon/v1/health | Statuscheck, zonder sleutel |
GET | /falcon/v1/feedback | Meldingen ophalen, te filteren op status |
GET | /falcon/v1/feedback/{id} | Eén melding ophalen |
PATCH | /falcon/v1/feedback/{id} | Status of link naar de pull request bijwerken |
POST | /falcon/v1/feedback/{id}/comments | Reactie van de agent toevoegen |
GET | /falcon/v1/feedback/{id}/comments | Reacties bij een melding ophalen |
Installeren
Plugin op de site, agent op je machine.
De plugin vraagt WordPress 6.0 en PHP 8.0 of nieuwer. De agent vraagt bash 4, curl, jq, git, een ingelogde gh en de claude-CLI.
Plugin
# Plugin naar WordPress kopiëren cp -r plugin/ wp-content/plugins/falcon-debugger/ # Activeren en een API-sleutel maken onder FalconDebugger > Settings
Agent
cd agent/ ./install.sh # Zet de API-URL, de sleutel en het pad naar je repo in .env ./falcon-agent.sh --test # verbinding testen ./falcon-agent.sh --run # meldingen één keer verwerken ./falcon-agent.sh --loop # elk half uur kijken
Meebouwen
Iets gevonden, of een idee?
FalconDebugger staat open op GitHub onder GPL-2.0 of later. Meld een probleem, stuur een pull request of maak er je eigen versie van.