PressCare Error Doctor with AI

Find and fix WordPress errors before they become fatal.

PressCare Error Doctor with AI is an original, read-only WordPress diagnostics plugin by Kevin Kemp - PressCare. It groups noisy PHP and WordPress errors, removes sensitive data, and uses the provider-independent AI Client in WordPress 7.0 to generate cautious, structured explanations.

Version 1.2.9 is the current public release. The plugin is not a fork. Its bundled provider adapters are unmodified, GPL-licensed source from the official WordPress AI Team projects, with exact upstream versions and commits documented in providers/UPSTREAM.md.

Compatibility

• WordPress: 7.0 or newer
• Tested through: WordPress 7.0.x
• PHP: 8.0 or newer
• Recommended production PHP: 8.3
• CI matrix: PHP 8.0, 8.1, 8.2, 8.3, and 8.4

WordPress 7.0 is intentional: it supplies the stable, provider-independent AI Client and Connectors credential interface. Requiring PHP 8.0 provides modern language features without limiting the plugin to only the newest hosting platforms.

Version 1.2.9 scope

1. Locate a configured WordPress or PHP error log.
2. Read only the final 2 MB.
3. Parse and group recognized PHP and WordPress error events.
4. Let the administrator review today, the last 24 hours, the last 7 or 30 days, or custom From and To dates.
5. Attribute paths to a plugin, theme, WordPress core, or an unknown component.
6. Rank current findings, group them by component, and collapse non-critical component rows for faster scanning.
7. Keep entries outside the selected dates out of the action plan while reporting one quiet excluded-entry count.
8. Put active fatal errors first, while labeling fatal findings from deliberately selected past dates as past evidence rather than active failures.
9. Provide severity-aware impact and resolution guidance without modifying the site.
10. Show an optional collapsed site snapshot after the workflow with environment, transient, and autoloaded-option context.
11. Explain the configured log source and create a sanitized print view that can be saved as PDF.
12. Let each administrator mark findings handled until a newer occurrence reopens them.
13. Redact database identifiers, common secrets, and personal data before storage.
14. Store the sanitized report only for the administrator who ran it.
15. Export the sanitized report as JSON.
16. Let an administrator connect OpenAI, Anthropic, or Google directly in Error Doctor using the bundled official provider adapters and WordPress-managed credentials.
17. Explain that consumer chat subscriptions do not include OpenAI or Anthropic API usage and that Google offers a limited API free tier.
18. With explicit approval, request a focused or complete structured explanation from the provider selected for Error Doctor.
19. Let an administrator explicitly open a PressCare repair request using only the sanitized finding ID, severity, and component slug.
20. Use cost-controlled primary and fallback models, cap AI output at 4,000 tokens, and show a clearly qualified typical-cost estimate before optional paid requests.

The plugin does not edit files, alter configuration, clear logs or transients, flush caches, change autoload settings, deactivate plugins, install updates, or apply AI-generated fixes.

Development

Install development dependencies:

composer install

Run validation:

composer lint
composer test

Build an installable ZIP:

./build.sh

Project links

• Product: https://presscare.com/presscare-error-doctor/
• Support: https://presscare.com/contact/
• Private security reports: https://presscare.com/contact/
• Author: https://presscare.com
• Source: https://github.com/kevinkempeng/WP-AI-Doctor

License

GPLv2 or later. See LICENSE.