8000 No Windows (WSL) install path in INSTALL.md · Issue #26 · simon-inkie/inkie-deck · GitHub
[go: up one dir, main page]

Skip to content

No Windows (WSL) install path in INSTALL.md #26

Closed

Description

@simon-inkie

Problem

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.

From the 2026-09-27 Windows/WSL install test.

Metadata

Metadata

Assignees

No one assigned

    Labels

    installInstall / setup flowpriority:P1Blocks a normal user

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0