feat: Add Windows compatibility guide and installer support#704
Open
chrisglick wants to merge 1 commit intodanielmiessler:mainfrom
Open
feat: Add Windows compatibility guide and installer support#704chrisglick wants to merge 1 commit intodanielmiessler:mainfrom
chrisglick wants to merge 1 commit intodanielmiessler:mainfrom
Conversation
…essler#440, danielmiessler#543, danielmiessler#385) Claude Code does not expand ${VAR} in hook command strings — only in .mcp.json. On macOS/Linux the shell handles expansion, but on Windows cmd.exe ignores ${VAR} syntax entirely, causing all hooks to fail with "Module not found". Changes: - Add resolveHookPaths() to installer config step — resolves ${PAI_DIR} to absolute paths and adds "bun" prefix for .ts files (Windows only, no-op on macOS/Linux to preserve dynamic env var flexibility) - Add MINGW/MSYS/CYGWIN detection to install.sh with friendly redirect to the compatibility guide instead of a generic error - Add Releases/v3.0/WINDOWS_COMPATIBILITY.md covering manual install, known issues (stdin, colons, voice), and workarounds - Reference the guide from root README and v3.0 release README Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4 tasks
3 tasks
nsalvacao
added a commit
to nsalvacao/Personal_AI_Infrastructure
that referenced
this pull request
Feb 17, 2026
…bility guide + installer support)
Contributor
Author
Research Note: Why Install-Time Resolution Is CorrectWhile reviewing this PR, I investigated whether we could use Finding: It won't work. There's a known Claude Code bug:
Even if the bug were fixed, there's a shell ambiguity problem:
Conclusion: |
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.
Summary
Releases/v3.0/WINDOWS_COMPATIBILITY.md) — comprehensive manual installation steps, known issues, and workarounds for running PAI on Windowsinstall.shnow detects MINGW/MSYS/CYGWIN and directs users to the compatibility guide instead of failing with "Unsupported platform"resolveHookPaths()inactions.tsresolves${PAI_DIR}in hook commands on Windows only (complete no-op on macOS/Linux), sincecmd.exedoesn't expand${VAR}syntaxProblem
Claude Code hooks on Windows fail with
Module not found "${PAI_DIR}/hooks/..."because:${PAI_DIR}in hook command strings is expanded by/bin/shon macOS/Linux, but Windows hooks execute throughcmd.exewhich uses%VAR%syntax.tshook files have#!/usr/bin/env bunshebangs that work on Unix but not Windows — they need explicitbunprefixingChanges
Releases/v3.0/WINDOWS_COMPATIBILITY.mdReleases/v3.0/.claude/PAI-Install/engine/actions.tsresolveHookPaths()— Windows-only, no-op on macOS/LinuxReleases/v3.0/.claude/PAI-Install/install.shREADME.mdReleases/v3.0/README.mdDesign Decisions
resolveHookPaths()returns immediately on non-win32platforms. No behavioral changes for existing users.settings.jsonstill uses${PAI_DIR}— resolution happens at install time only, so the template remains portable./separators since both Bun and Node.js handle them correctly on Windows.Test plan
install.shon macOS/Linux still works unchangedinstall.shon Windows (Git Bash/MSYS) shows compatibility guide messageresolveHookPaths()is a no-op whenprocess.platform !== "win32"Closes #440, #543, #385
🤖 Generated with Claude Code