WinUseAgent

Windows tools and a CUA harness in one WUA-CLI.exe.

WUA-CLI.exe CUA Inspect OutFile=desktop.png
WUA-CLI.exe CUA Inspect Handle=<hex> OutFile=window.png
WUA-CLI.exe CUA Mouse Operation=Click Handle=<hex> X=120 Y=80
WUA-CLI.exe CUA Text Handle=<hex> "Text=hello"

CUA provides desktop/window inspection, UIA, window operations, input and child sessions. Omit Session for the caller's Windows session, or specify a Windows session ID. Omit Handle or use 0 for the desktop; a hexadecimal handle selects a window. Coordinates belong to the screenshot, starting at its upper-left corner. Window screenshots include the nonclient area.

Read the agent workflow and tool reference. OutFile requests a PNG at the specified path. Without it, inspection returns information without taking a screenshot.

Build

Use Visual Studio's C++ workload, Windows SDK and NuGet CLI. Restore dependencies and build the whole solution:

nuget restore Source/WUA-CLI/packages.config -PackagesDirectory Source/packages
msbuild Source/WinUseAgent.slnx /m /p:Configuration=Release /p:Platform=x64
msbuild Source/WinUseAgent.slnx /m /p:Configuration=Release /p:Platform=x86

Outputs are in Source/OutDir/<architecture>/<configuration>/. See integration tests and runtime design for development.