Troubleshooting

Chat cuts off mid-stream

• Increase reverse-proxy read timeout for /wp-json/mindfulagent/v1/chat/stream.
• Disable buffering on CDNs (e.g. Cloudflare) for SSE endpoints.

500 errors after activation

• Confirm PHP 8.1+ and required extensions.
• Enable WP_DEBUG_LOG and check for autoload errors (vendor-prefixed libraries).

Frontend blank

• Run npm run build in frontend/.
• Clear caches and hard-refresh.

Model list empty

• Verify API key scope and provider status.
• Check OpenRouter / provider dashboards for outages.

Licensing / tier

• Contact admin@mindfuldesign.me per README for tier limits.

Support: support@mindfuldesign.me.