Add optional Windows unattended-run toolkit (hidden autostart + QR-recovery watchdog) - #284
Open
jorgeschnura wants to merge 1 commit into
Open
Add optional Windows unattended-run toolkit (hidden autostart + QR-recovery watchdog)#284jorgeschnura wants to merge 1 commit into
jorgeschnura wants to merge 1 commit into
Conversation
…dog) Adds a windows/ folder and a WINDOWS.md docs page (linked from the existing Windows Compatibility section) that make the Go whatsapp-bridge run reliably unattended on Windows. Purely additive: the Python MCP server and Go bridge are unchanged; nothing on macOS/Linux is affected. Contents: windows/start-whatsapp-hidden.vbs launch the bridge hidden, no-wait windows/start-whatsapp-bridge.bat auto-restart loop, UTF-8 console, log windows/qr-bridge.bat visible window to scan the QR windows/whatsapp-bridge-watchdog.ps1 recover-first watchdog windows/install.ps1 register hidden autostart + watchdog task WINDOWS.md step-by-step Windows setup Why: the bridge only opens :8080 as an interactive user process (not as a LocalSystem service); running it hidden with auto-restart and a watchdog that only surfaces the QR when the session is truly unlinked closes that gap. No script hard-codes a path (WHATSAPP_MCP_DIR env var or script-relative). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR adds an optional
windows/folder with a small, self-contained toolkit that makes the Gowhatsapp-bridgerun reliably unattended on Windows, plus aWINDOWS.mddocs page linked from the existing "Windows Compatibility" section of the README.It is purely additive: nothing that works today on macOS/Linux changes, and the Python MCP server and Go bridge are untouched. It only adds the Windows process-management layer around them.
Why Windows needs this
Running the bridge unattended on Windows hits three practical gaps:
whatsmeowlinks WhatsApp Web's multi-device session in the interactive user context. Run the bridge as a LocalSystem service and it starts, but its:8080REST port never opens, so the MCP server has nothing to connect to. Running it as the logged-in user is the only configuration that reliably brings:8080up.bridge.logactually shows the session is unlinked.What's added
windows/start-whatsapp-hidden.vbs— launches the bridge hidden, fire-and-forget.windows/start-whatsapp-bridge.bat— auto-restart loop; UTF-8 console so a logged QR stays legible; writesbridge.log.windows/qr-bridge.bat— runs the bridge in a visible window so the QR is scannable.windows/whatsapp-bridge-watchdog.ps1— recover-first watchdog (:8080check, silent relaunch, QR window + notification only when truly unlinked).windows/install.ps1— registers hidden autostart (at-logon scheduled task or Startup shortcut) + the watchdog scheduled task; parameterized with-WhatsAppMcpDir, with a matching-Uninstall.WINDOWS.md— step-by-step Windows setup, assuming the Go bridge is already built.Notes
WHATSAPP_MCP_DIRenv var or their own location.:8080only opens as a user process (that is the whole reason this exists).Timeout waiting for QR,Scan this QR code); if that wording ever changes, one line updates.Happy to adjust naming, folder placement, or the README link to fit the project's conventions. A standalone version also lives at whatsapp-mcp-windows for users who find it before this lands.