dsh-bat2exe

dsh plugin --profile web add dsh-bat2exe

dsh-bat2exe

Turn a Windows .bat / .cmd launcher into a real .exe — from inside DeepSeek Harness.

The EXE is a thin shell: it locates the batch file next to itself and hands the

whole job to cmd.exe. The launcher logic stays editable text, no tool path is baked

into the binary, and upgrading whatever the batch file calls needs no recompilation.

Install

dsh plugin --profile web add dsh-bat2exe

Restart DSH, then ask the agent to build a launcher — or call the tool directly.

Tools

bat2exe_build

Parameter · Meaning

bat · required — path to the .bat/.cmd file (absolute, or relative to the working directory)

name · output executable name; defaults to the batch name with .exe

iconText · up to four characters drawn on a generated icon

iconTextColour · icon text colour as #rrggbb

icon · use an existing .ico instead of rendering one

startMenuShortcut · also write a Start Menu shortcut

desktopShortcut · also write a Desktop shortcut

The build runs four steps, all local and offline:

1. Icon — renders a rounded-square plate with a diagonal gradient and the given

text, using a built-in 5×7 bitmap font, then packs it as a 256×256 ICO. No image

library, no external tool.

2. C# shell — emits a wrapper whose only job is to run the batch file from its own

directory, forwarding all arguments and preserving the exit code.

3. Compile — csc.exe from the .NET Framework (falling back to dotnet build when

only the .NET SDK is present), with the icon embedded as a resource.

4. Shortcuts — optional .lnk files, written through WScript.Shell.

bat2exe_probe

Reports the local toolchain — C# compiler path, .NET SDK presence, PowerShell, and the

resolved defaults — so a failure can be diagnosed before a build is attempted.

Settings

bat2exe registers a settings namespace, so defaults are editable in

Settings → Plugins rather than by hand-editing a profile patch:

Key · Default · Meaning

iconText · BAT · text drawn on a generated icon

iconFrom / iconTo · #12204a / #4a6cf7 · gradient start / end

workDir · .bat2exe · where .cs, .ico and other by-products go

startMenuShortcut · false · default for the Start Menu shortcut

desktopShortcut · false · default for the Desktop shortcut

Per-call tool arguments always win over these defaults.

Requirements

• Windows. The pipeline compiles a Windows PE and writes .lnk files.
• A C# compiler: .NET Framework 4.x (csc.exe, present on stock Windows) or the .NET SDK.
• PowerShell for shortcut creation only (pwsh preferred, Windows PowerShell accepted).

bat2exe_probe reports exactly which of these were found.

What gets written

Everything lives next to the batch file, so a launcher folder is self-contained:

DSH-Web.bat            <- your launcher (unchanged)
DSH-Web.exe            <- the compiled shell
.bat2exe/
  DSH-Web.ico          <- generated (or your supplied) icon
  DSH-Web.cs           <- the emitted C# source, kept for inspection

License

MIT