Windows UI Automation from WSL: enumerate top-level windows, read a bounded element tree, and wait for or trace the path to a named element.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:173787247/dsh-wsl-uia
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
DeepSeek Harness plugin: Windows UI Automation observation from WSL: enumerate top-level windows and read a bounded element tree with per-observation handles.
Part of dsh-wsl-kit.
Install
dsh plugin --profile web add github:173787247/dsh-wsl-uia
Usage
uia_tree action=windows # list top-level windows
uia_tree action=tree pid=1234 maxDepth=6 maxElements=200 # bounded element tree
uia_tree action=find controlType=Button actionableOnly=true
Notes
Every element carries a handle like 1790525657168.6. The number before the dot is
the observation epoch, so a handle from an older observation is identifiable. Element
index is not a stable identity on a live window — two walks of the same tree can
disagree — so pass expectName to win_invoke rather than relying on position.
Requirements
- Windows with WSL, and DeepSeek Harness running inside it.
- PowerShell reachable at the standard path (the plugin finds it itself).
Tests
npm test
The unit tests run anywhere. The live tests are skipped outside WSL.
Compatibility
| Field | Value |
|---|---|
| Plugin | dsh-wsl-uia 0.1.0 |
| Minimum dsh | ≥ 0.1.2 (web UI one-shot ?token= on Windows relay :3081) |
| Latest verified | See dsh-wsl-kit Compatibility (currently 0.2.2-rc.5) — single source of truth for the suite |
| Kit set | full or install alone |
License
MIT
Links
More in this category
6Mikao9/dsh-wsl-workspace★ 124
Add a WSL workspace from the web GUI without needing to install dsh or related tools again inside WSL. Bash commands and file read/write operations run within the local WSL distribution on the host machine, while Windows files remain accessible.
XINY11451/dsh-wsl★ 14
Extends the working range of DSH into WSL. Files in the distribution can be read, written, edited and searched by DSH directly. Depending on the task, the AI chooses for itself: run a one-off command, or open its own terminal and run several commands there to finish the job. Typing `dsh` in a WSL terminal calls DSH (type `dsh help` there for details), fusing WSL and DSH deeply. Every terminal you open can collaborate visually with the AI.
Edge-Echo/dsh-win-toolkit★ 4
Windows-native tools for DSH agents: clipboard read and write, system notifications, hosts file inspection and network diagnostics, each returning structured data with UI cards from injection-safe PowerShell.
Han-1413141/dsh-wsl-native★ 4
Use Windows and native Linux DSH sessions in one Windows window, with WSL environment switching and bidirectional system tools.
stallenlu/dsh-wsl-suite★ 4
WSL workspaces for DeepSeek Harness. A sidebar W button lists installed distros and registers a Linux folder as a host workspace addressed by a UNC path, and the sidebar terminal opens a real Linux pty inside the distribution for WSL sessions. A persistent zero-dependency agent running in the distro answers file, shell and search requests over a JSON-lines pipe, so no polling timers touch the distribution while it is idle and /mnt drives stay reachable from tools and the terminal (registering one as a workspace is refused, because the host realpaths workspace paths and Windows cannot resolve drvfs); grep and glob run the distro's own ripgrep. WSL preset twins such as wsl-standard swap in the WSL shell and fs tools. A rebuild of 6Mikao9/dsh-wsl-workspace — do not install both: they mount the same W entry in the Workspaces header, publish the same wsl-<mode> presets, and each wrap the host's single-slot terminal provider.
173787247/dsh-wsl-env★ 3
Injects WSL distro, Linux path mapping, /mnt/c CRLF and git caveats, and NODE_USE_ENV_PROXY into the system prompt.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.