Screenshots From the README of dummylabs/thewatchman.
About
Watchman is a custom integration that tracks missing entities and actions referenced in Home Assistant config files. It scans YAML files for referenced entities and actions, checks each entity's current state, and reports those that are missing or unavailable, and checks that actions exist in the registry. Parsing is lightweight and based on line-by-line heuristics, so it can produce false positives and false negatives. The report can be saved as a text file or sent through a notification method, and a report action and a button create the report file. Diagnostic sensors cover status, missing entities, missing actions, last parse, parse duration, and processed and ignored files. Options include folders to watch, ignored entities, files, labels and states, report layout, and masking of names in logs, and it is set up in the UI.
Automatic summary of the README and code of dummylabs/thewatchman. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Provides
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
After setup
- Folders to watch:Comma-separated list of folders where watchman should look for config files
- Ignored entities and actions:Add entities and actions to exclude from tracking. Supports glob patterns (e.g. switch.*)
- Exclude entities with the states below from the report:Comma-separated list of the states excluded from tracking
- Exclude disabled automationsExclude entities used only by disabled automations
- Ignored files:Add file glob patterns to exclude from tracking (e.g. */esphome/*)
- Ignored labels:Use labels to exclude entities from tracking
- Parse UI controlled dashboards
- Startup delay for watchman sensors initialization
- Obfuscate sensitive data in logsWhether to mask entity and action names in debug logs for privacy
- Enforce max file size limit
- List of report columns width, e.g. 30, 7, 60
- Custom header for the report
- Report file location e.g. /config/report.txt
- Add entity friendly names to the report
Texts from the code of dummylabs/thewatchman.
Entities
- ButtonsCreate Report File
- SensorsLast Update, Missing Entities, Missing Actions, Status, Parse Duration, Last Parse, Processed Files, Ignored Files
- TextsIgnored Labels
Actions
- ReportRun the Watchman reportFields: Create file report, Send report as notification, Notification action data parameters, Force full configuration rescan, Notification message chunk size
- Set ignored labelsOverwrite the list of labels to ignore.Fields: Labels
From the README
Home Assistant setups evolve over time—entities can disappear, and services/actions may be renamed by integrations. Watchman helps you spot these changes early by scanning your configuration for references to missing or renamed entities, so you can fix issues before automations break. Discussion on Home Assistant Community Forum
Shows in Vulpo
Button card, Chart card, Apple Watch.Information
- Installs
- 18.5k sharing analytics
- GitHub stars
- 692
- Connection
- Works locally
- Upkeep
- No update in 6 to 18 months
- Version
- v0.8.4,
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
watchman- Issues
- Report an issue














