Theuws.com / tools Inventarisatie

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.

  1. 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.
  2. 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.
  3. 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.

MethodeRouteWat het doet
GET/falcon/v1/healthStatuscheck, zonder sleutel
GET/falcon/v1/feedbackMeldingen 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}/commentsReactie van de agent toevoegen
GET/falcon/v1/feedback/{id}/commentsReacties 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.