8000 Warn when the resolved claude is a Windows binary under /mnt/ (#31) by simon-inkie · Pull Request #60 · simon-inkie/inkie-deck · GitHub
[go: up one dir, main page]

Skip to content

Warn when the resolved claude is a Windows binary under /mnt/ (#31) - #60

Merged
simon-inkie merged 2 commits into
mainfrom
31-warn-windows-claude
Oct 12, 2026
Merged

simon-inkie merged 2 commits into
mainfrom
31-warn-windows-claude

Conversation

@simon-inkie
Copy link
Copy Markdown
Owner

Requested by Simon · project thread

Fixes #31

What was wrong: on WSL, PATH often includes Windows directories, so command -v claude can resolve to a Windows binary under /mnt/c/.... Agents then fail to start with no clear reason.

What changed:

  • New shared packages/base/bin/claude-binary-check.sh with warn_if_foreign_claude. A path under /mnt/ or ending .exe or .cmd prints a warning naming the path, the problem and the fix (install the Linux build, or put its directory earlier in PATH).
  • Called from boot-agents.sh, workspace.sh and create-agent.sh.
  • Warn only, not stop: a Windows claude can still work through WSL interop, so blocking would break working setups.
  • INSTALL.md note under Known limitations; SPEC at .specs/31-warn-windows-claude/SPEC.md.

Verified: new claude-binary-check.test.sh (fake /mnt/c path, .exe/.cmd, normal paths, absent claude) passes and is registered in shell-suites.test.ts. pnpm typecheck, check:boundaries, check:leaks, check:licence, check:lib-version and check:dashes pass.

Not verified: no real WSL machine. pnpm test shows 4 failures (inbox.test.sh, inbox-push.test.sh, pane-idle.test.sh, one create-agent "no runtime on PATH" case) that fail identically on clean main in this container.

🤖 Generated with Claude Code


Generated by Claude Code

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Claude <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Claude <noreply@anthropic.com>
@simon-inkie
simon-inkie merged commit 9c1487b into main Oct 12, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Warn when the resolved claude is a Windows binary under /mnt/

2 participants

0