drover:add-project

You can register a Drupal DDEV project for log monitoring by adding its folder path to the drover tracking list. The onboarding process reads your .ddev/config.yaml file and records the project path into a persistent state file for automated tailing.

To start streaming drush watchdog logs, you need a valid Drupal site running on DDEV with an accessible .ddev/config.yaml file. The registration process optionally resolves drush aliases and git remote information to enrich the monitoring setup.

Yes, you can safely re-add the same Drupal project path without creating duplicates. The project onboarding process uses idempotent behavior, meaning re-registering an existing project path acts as a no-op and prevents duplicate entries in the tracking list.

Yes, project onboarding differs by operating system. On macOS, the registration uses folder selection dialogs, while non-macOS environments require you to pass the specific project path as a direct argument to complete the registration.

Drover reads the .ddev/config.yaml file during project registration to validate the DDEV environment context. This configuration data, along with optional drush aliases and git remote details, enriches the persistent state record used to start automated log tailing.