You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Windows is listed as unverified with no guidance. The test hit several WSL-specific traps that a stranger would not get past unaided.
Evidence
Seen in test: a draft Windows section existed but was unused; Docker Desktop's own distro can end up as the default WSL distro instead of Ubuntu; a non-interactive first launch of Ubuntu leaves you logged in as root with no user created; WSL appends the Windows PATH, so a Windows claude npm shim is found and runs half-configured; signing in to the model CLI inside WSL means copying a URL out and approving in the Windows browser, then pasting a code back; and the install should not be trusted from the Windows-mounted home folder — sign in from a throwaway folder instead.
Fix
Add a "Windows (via WSL)" section before section 1 covering: launching the intended Ubuntu distribution explicitly and the root-user recovery path if the non-interactive first launch skipped user creation; setting the default WSL distribution explicitly; installing the model CLI inside Ubuntu itself and turning off Windows PATH interop for it; the sign-in walkthrough (copy URL, approve in Windows browser, paste code); the trust-home warning; cloning under the Linux home directory, not a Windows-mounted path; opening the local URL from the Windows browser; and running Deck in tmux rather than the foreground (see the linked "Deck dies when you close the terminal" issue). Use a placeholder agent name consistent with the walkthrough elsewhere in the docs.
Acceptance criteria
A person following only INSTALL.md on a clean Windows 11 machine reaches tier 3 with a replying agent.
Every command in the section is either extractable and runnable by the install-verification rig, or explicitly marked as Windows-only and untested by the rig.
Activity
docs(install): address review of the WSL section (#26)
docs(install): rename Windows keep-running heading to fix anchor clash (
docs(install): enable and linger for the WSL service (#26)
docs(install): enable and linger for the WSL service (#26)
No Windows (WSL) install path in INSTALL.md (#26) (#59)
simon-inkie commentedon Nov 19, 2026
Delivered by PR 59 (WSL install path in INSTALL.md). Closing.