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