FalconDebugger

OPEN SOURCE WordPress CLI v1.0.0 GPLv2

Autonomous feedback-to-fix pipeline for WordPress. Users report bugs via a widget, a CLI agent polls for new feedback, pipes it to Claude Code for autonomous fixes, and creates pull requests automatically. Inspired by Joost de Valk's autonomous feedback pipeline at Rondo Club.

View on GitHub Download ZIP

Components

1.0.0

Version

API Endpoints

External Deps

How it works

From bug report to pull request in three steps — fully autonomous.

User reports bug

Click "Report Bug" in the admin bar or press Ctrl+Shift+F. Auto-captures URL, browser, screen size.

Agent picks it up

The CLI agent polls the REST API, picks up new feedback, and sends it to Claude Code with full context.

PR created

Claude Code fixes the bug autonomously, creates a branch, commits, and opens a pull request on GitHub.

Features

Everything you need for an autonomous bug-fixing pipeline.

Feedback Widget

Admin bar button and Ctrl+Shift+F keyboard shortcut. Captures bug type, priority, title, description, plus auto-captured page URL, user agent, screen size, and language.

Autonomous Fixing

The CLI agent sends structured prompts to Claude Code CLI. Claude analyzes the bug, creates a fix, and the agent handles git branching, committing, and PR creation.

Multisite Support

Network-activate on WordPress multisite: the feedback widget appears on all subsites, but all feedback is stored centrally on the main site. Each item records blog_id and site info.

Multilanguage

Polylang and WPML integration with graceful degradation. Captures language slug, locale, and translation group. Works identically without either plugin.

Security

SHA-256 hashed API keys (shown once on generation), configurable rate limiting per hour, IP whitelist, role-based widget visibility, and nonce verification throughout.

GitHub Integration

Automatic branch creation, pull request with structured description, optional auto-squash-merge, and Copilot review. Uses the gh CLI for all GitHub operations.

REST API

All endpoints require X-Falcon-Key header (except /health).

Method	Route	Description
GET	/falcon/v1/health	Status check (no auth required)
GET	/falcon/v1/feedback	List feedback (filterable by status)
GET	/falcon/v1/feedback/{id}	Get single feedback item
PATCH	/falcon/v1/feedback/{id}	Update status or PR URL
POST	/falcon/v1/feedback/{id}/comments	Add agent comment
GET	/falcon/v1/feedback/{id}/comments	Get comments for feedback

Tech Stack

Two components, zero external dependencies.

Plugin

PHP 8.0+, WordPress 6.0+, Custom Post Type, REST API

Agent

Bash 4.0+, curl, jq — zero npm/pip dependencies

AI

Claude Code CLI with structured prompts

Version Control

git + GitHub CLI (gh) for PRs

Security

SHA-256 keys, rate limiting, IP whitelist, nonces

Scheduling

macOS launchd or Linux cron

Requirements

WordPress 6.0 or later

PHP 8.0 or later

Claude Code CLI claude command available

GitHub CLI gh, authenticated

bash 4.0+, curl, jq, git

Optional Polylang or WPML

Installation

Set up the plugin and the agent separately.

Plugin (WordPress)

# Copy plugin to WordPress
cp -r plugin/ wp-content/plugins/falcon-debugger/

# Activate and generate API key in FalconDebugger > Settings
            

Agent (Developer Machine)

cd agent/
./install.sh

# Configure .env with your API URL, key, and repo path
# Then test the connection:
./falcon-agent.sh --test

# Process feedback
./falcon-agent.sh --run

# Continuous polling (every 30 min)
./falcon-agent.sh --loop
            

Contributing

FalconDebugger is open source and welcomes contributions from everyone.

View on GitHub Report Issue

License: GNU General Public License v2.0 · Tags: wordpress, debugging, claude-code, autonomous, feedback, pull-requests