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:
- 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.
- 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.
- 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.
- 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
