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:
parent
887e209abc
commit
82c4542090
2 changed files with 17 additions and 6 deletions
15
README.md
15
README.md
|
|
@ -57,18 +57,25 @@ sleep consolidates 30-session windows into morning markdown reports.
|
|||
- **macOS** (arm64 + x64) — fully supported, primary dev target.
|
||||
- **Linux** (Ubuntu, Debian, Fedora, Arch — x64 + arm64) — fully supported.
|
||||
- **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:
|
||||
- **WSL2** (recommended) — install Windows Subsystem for Linux,
|
||||
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
|
||||
Claude Desktop / VS Code MCP config to get `spawn_agent` +
|
||||
`kei_bash`/`kei_edit`/`kei_write` tools, without the full
|
||||
Bash-based substrate. Skills, hooks, and `kei` CLI not available
|
||||
in this mode.
|
||||
- Native PowerShell port: not on the roadmap (would double maintenance
|
||||
surface; WSL gives 100% coverage with 0 duplication).
|
||||
- **Native PowerShell port** — demand-driven. WSL gives 100%
|
||||
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
|
||||
|
||||
|
|
|
|||
|
|
@ -139,8 +139,12 @@ case "$OS" in
|
|||
err "Detected: bare Windows ($OS) via Git Bash / Cygwin / MSYS."
|
||||
err ""
|
||||
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 "on the roadmap (would double maintenance; WSL gives 100% coverage)."
|
||||
err "it will not run reliably outside WSL2."
|
||||
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 "Path forward (one-time setup, ~5 min + reboot):"
|
||||
err ""
|
||||
|
|
|
|||
Loading…
Reference in a new issue