From f117b2c8a7a50e16792ded1498aca4ffc0fae387 Mon Sep 17 00:00:00 2001
From: Dan Shapiro <3732858+danshapiro@users.noreply.github.com>
Date: Sun, 2 Aug 2026 22:18:17 -0700
Subject: [PATCH] docs(agents): WSL desktop builds target the Windows Electron
 app

On WSL machines "the desktop app" means the Windows app: build via
npm run electron:build:win + the NSIS installer, never a Linux
AppImage/deb under WSLg. WSL cannot compile node-pty for win32, so
drive the build from WSL by rsyncing to a Windows-local dir and
running Windows npm via cmd.exe.

Generated with Amplifier

Co-Authored-By: Amplifier <240397093+microsoft-amplifier@users.noreply.github.com>
---
 AGENTS.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index 267fd8b46..774d18a3a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -117,7 +117,7 @@ npm run serve               # Build and run production server
 # `npm run check` for safe verification, or build from a worktree.
 ```
 
-Windows desktop builds (`npm run electron:build:win`) must run on native Windows — see [docs/development/windows-electron-build.md](docs/development/windows-electron-build.md).
+**On WSL machines, "the desktop app" means the Windows app.** Always build, install, and launch the Windows Electron app (`npm run electron:build:win` + the NSIS installer) — never a Linux AppImage/deb under WSLg. The Windows build must run as a native Windows process (WSL cannot compile `node-pty` for win32); drive it from WSL by rsyncing to a Windows-local dir and running Windows npm via `cmd.exe` — see [docs/development/windows-electron-build.md](docs/development/windows-electron-build.md).
 
 ### Testing
 ```bash