Skip to content

Add --verbose flag to doctor check command#207

Draft
Copilot wants to merge 3 commits intomainfrom
copilot/add-verbose-flag-checks
Draft

Add --verbose flag to doctor check command#207
Copilot wants to merge 3 commits intomainfrom
copilot/add-verbose-flag-checks

Conversation

Copy link

Copilot AI commented Feb 12, 2026

Users on large WordPress sites (30k+ posts, 200k+ comments) reported wp doctor check --all appearing to hang at 12% with no indication of progress or what check was executing.

Changes

  • Added --verbose flag to display check execution progress:

    • Check name before execution: Running check: {name}
    • Status after completion: Status: {status}
    • File scan progress every 1000 files: Scanned {count} files...
    • Total files scanned: Total files scanned: {count}
  • Disabled progress bar when verbose active - the two modes interfere visually

  • Added VERBOSE_FILE_SCAN_INTERVAL constant for scan progress interval (1000 files)

Example Output

$ wp doctor check --all --verbose
Running check: autoload-options-size
  Status: success
Running check: core-update
  Status: success
Scanning filesystem for file checks...
  Scanned 1000 files...
  Scanned 2000 files...
  ...
  Scanned 12000 files...
  Total files scanned: 12543
Running check: php-in-upload
  Status: warning

Default behavior unchanged - verbose mode is opt-in.

Original prompt

This section details on the original issue you should resolve

<issue_title>Introduce --verbose flag to provide more visibility into what checks are doing</issue_title>
<issue_description>Run wp doctor check command as follows:
[root@server production]# wp doctor check --all --allow-root

Check begins but never gets past 12%

Running checks 12 % [====================> ] 0:16 / 2:15[root@server production]#

Expected behavior is that it completes or returns an error message.

Ideally a fix would complete the scan, alternatively provide a verbose error message.

Thanks!

PHP 8.0, WP 6.0.3, updated to latest production version of WP CLI and doctor package.
Large WP site, 30,000 posts, 200,000 comments. 16GB 4CPU VPS on centos/apache</issue_description>

Comments on the Issue (you are @copilot in this section)

@danielbachhuber Thanks for the report, @bozzmedia !

I imagine it's processing a large body of data (files or in your database) for a specific check, and is slow to update the progress indicator.

It would be nice to have a --verbose flag that gives you more visibility into what each check is doing.</comment_new>


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits February 12, 2026 22:39
Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>
Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>
Copilot AI changed the title [WIP] Introduce --verbose flag to improve check visibility Add --verbose flag to doctor check command Feb 12, 2026
Copilot AI requested a review from swissspidy February 12, 2026 22:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Introduce --verbose flag to provide more visibility into what checks are doing

2 participants