Windows Claude Dual-Shell CLI Access
Status
Implemented.
Context
GitHub issue #272 reported that Windows Claude sessions could not reliably run the wardian CLI from shell tools. Wardian installed a wardian.cmd shim for native Windows shells, but Claude can also execute commands through Git Bash-compatible POSIX shells where .cmd dispatch is not the primary lookup surface.
Decision
On Windows, Wardian installs two launchers in the managed CLI bin directory:
wardian.cmdfor PowerShell and cmd.wardianfor POSIX shell lookup through Git Bash, MSYS2, and similar bash environments.
Wardian-managed provider processes also receive the active managed CLI bin directory at the front of PATH. The PATH injection is Windows-only and is applied to interactive PTY launches and headless provider processes.
Behavior
- PowerShell and cmd resolve
wardianthroughwardian.cmd. - Git Bash resolves
wardianthrough the extensionless POSIX launcher. - The POSIX launcher delegates to
wardian-cli.exebeside the launcher. - PATH injection is idempotent and does not duplicate the managed
bindirectory if it is already present.
Verification
Local Windows smoke checks were run with a temporary managed bin directory containing wardian-cli.exe, wardian.cmd, and the extensionless POSIX launcher:
- PowerShell resolved
wardiantowardian.cmdandwardian --versionreturnedwardian 0.3.5. - Git Bash resolved
wardianto the extensionless launcher andwardian --versionreturnedwardian 0.3.5.
The runtime-level smoke remains to launch a Wardian-managed Claude session on Windows and run wardian agent from both native shell and bash-backed tool contexts inside that session.