DeepSeek Harness Plugin

173787247/dsh-wsl-winctl

Stars ★ 1 Category WSL & Windows Interop Added 2026-10-08

Enumerate and control Windows top-level windows from WSL: activate, minimize, maximize, restore, move, resize, set always-on-top, close.

Install

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:173787247/dsh-wsl-winctl

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: Enumerate and control Windows top-level windows from WSL: activate, minimize, restore, move and resize.

Part of dsh-wsl-kit.

中文说明 → README.zh.md

Install

dsh plugin --profile web add github:173787247/dsh-wsl-winctl

Usage

win_windows action=windows
win_windows action=activate titleContains="Notepad"
win_windows action=move pid=1234 x=0 y=0 width=1280 height=800

Notes

Every action names its target by pid or titleContains; nothing acts on whatever happens to be focused. move requires a position and a positive size — a half-specified move is refused rather than guessed at.

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-winctl 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

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.