wpf-locator-doctor 0.2.0

dotnet tool install --global wpf-locator-doctor --version 0.2.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local wpf-locator-doctor --version 0.2.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=wpf-locator-doctor&version=0.2.0
                    
nuke :add-package wpf-locator-doctor --version 0.2.0
                    

WPF Locator Doctor

Testability scorecard for WPF apps. It checks whether the controls your UI tests need (buttons, text boxes, lists, menus, tabs…) have good AutomationIds: are they there, set on purpose, unique, still the same as last time, and visible to test tools. Each screen and the whole app get a score from 0 to 100 and a grade from A to F. Every problem comes with the file, the line, and the line of XAML to add.

Install

dotnet tool install -g wpf-locator-doctor --prerelease

You need the .NET SDK, version 10 or newer. Works on Windows, macOS and Linux.

Use

wpf-locator-doctor scan-source path/to/YourWpfProject

It prints a summary and writes two files into ./testability-report/:

  • testability-report.md: the report for people (grade, what each check found, every problem with its fix).
  • testability-report.json: the same data for tools. Pass it as --baseline next time to check that no IDs disappeared.

In a build pipeline, fail the build when the score drops:

wpf-locator-doctor scan-source src/MyApp --min-score 75 --baseline last-report.json --quiet

Exit codes: 0 OK · 1 score below --min-score · 2 wrong usage · 3 the scan failed.

Live scan of a running app (Windows)

This package contains the source scan, which reads your XAML and C# files. The live scan reads the running app through Windows UI Automation, the same thing test tools use. It is Windows-only, so it ships separately: download wpf-locator-doctor-live-win-x64.zip from the releases page. It needs the .NET 10 Desktop Runtime.

More

This is an early preview. Commands and report formats may change before 1.0. An MCP server, so AI assistants can find locators for you, is coming next.

Source code, full documentation and issues: https://github.com/swechhap/wpf-locator-doctor

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.2.0 0 11/22/2026
0.1.1-preview.1 6 11/21/2026