docs: Windows native port is demand-driven, not "never"

User feedback: "if there's a lot of requests, we'll make a native Windows
version". Soften the "not on the roadmap" framing in both README Platforms
section and bootstrap.sh's bare-Windows guidance.

- README: rephrase to "demand-driven. WSL gives 100% coverage today with
  0 code duplication. If you want a native .ps1 port, open / 👍 an issue.
  Once demand is real, we'll build it."
- bootstrap.sh: same softening — point users to the issues tracker so
  Windows-native demand becomes visible. WSL still recommended as the
  no-wait path that works today.

No version bump (docs-only, behaviour unchanged for all OS paths).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
KeiSei84 2026-05-27 14:46:33 +08:00
parent 887e209abc
commit 82c4542090
2 changed files with 17 additions and 6 deletions

View file

@ -57,18 +57,25 @@ sleep consolidates 30-session windows into morning markdown reports.
- **macOS** (arm64 + x64) — fully supported, primary dev target. - **macOS** (arm64 + x64) — fully supported, primary dev target.
- **Linux** (Ubuntu, Debian, Fedora, Arch — x64 + arm64) — fully supported. - **Linux** (Ubuntu, Debian, Fedora, Arch — x64 + arm64) — fully supported.
- **Windows** — substrate itself is Bash-only, but the **MCP server binary** - **Windows** — substrate itself is Bash-only, but the **MCP server binary**
ships as `kei-mcp-server-windows-x64.exe` in every release. Two ships as `kei-mcp-server-windows-x64.exe` in every release. Three
recommended paths: recommended paths:
- **WSL2** (recommended) — install Windows Subsystem for Linux, - **WSL2** (recommended) — install Windows Subsystem for Linux,
then run `bootstrap.sh` inside Ubuntu/Debian as normal. Full then run `bootstrap.sh` inside Ubuntu/Debian as normal. Full
substrate works. substrate works. `bootstrap.sh` auto-detects WSL2 and Git Bash;
on bare Windows it prints a one-time WSL setup guide and copies
the `wsl --install` command to your clipboard.
- **MCP-only** — drop `kei-mcp-server-windows-x64.exe` into your - **MCP-only** — drop `kei-mcp-server-windows-x64.exe` into your
Claude Desktop / VS Code MCP config to get `spawn_agent` + Claude Desktop / VS Code MCP config to get `spawn_agent` +
`kei_bash`/`kei_edit`/`kei_write` tools, without the full `kei_bash`/`kei_edit`/`kei_write` tools, without the full
Bash-based substrate. Skills, hooks, and `kei` CLI not available Bash-based substrate. Skills, hooks, and `kei` CLI not available
in this mode. in this mode.
- Native PowerShell port: not on the roadmap (would double maintenance - **Native PowerShell port** — demand-driven. WSL gives 100%
surface; WSL gives 100% coverage with 0 duplication). coverage today with 0 code duplication, so a native `.ps1`
substrate isn't built yet. If you want it, open an issue with
a thumbs-up on the existing Windows-native tracker (or file
one) — once demand is real, we'll build it. The MCP-server
binary path already covers the common "just want spawn_agent
in Claude Desktop" case.
## Maturity matrix ## Maturity matrix

View file

@ -139,8 +139,12 @@ case "$OS" in
err "Detected: bare Windows ($OS) via Git Bash / Cygwin / MSYS." err "Detected: bare Windows ($OS) via Git Bash / Cygwin / MSYS."
err "" err ""
err "KeiSeiKit's substrate is Bash-only and needs apt/brew + full POSIX —" err "KeiSeiKit's substrate is Bash-only and needs apt/brew + full POSIX —"
err "it will not run reliably outside WSL2. Native PowerShell port is NOT" err "it will not run reliably outside WSL2."
err "on the roadmap (would double maintenance; WSL gives 100% coverage)." err ""
err "A native PowerShell port is demand-driven — not built yet because"
err "WSL2 covers 100% with zero code duplication. If enough Windows users"
err "ask, we will ship one. Open / 👍 an issue at:"
err " https://github.com/KeiSeiLab/KeiSeiKit-1.0/issues"
err "" err ""
err "Path forward (one-time setup, ~5 min + reboot):" err "Path forward (one-time setup, ~5 min + reboot):"
err "" err ""