Skip to content

docs: Windows + Git Bash troubleshooting#66

Open
strix-tkellogg wants to merge 2 commits intomainfrom
docs/windows-git-bash-workaround
Open

docs: Windows + Git Bash troubleshooting#66
strix-tkellogg wants to merge 2 commits intomainfrom
docs/windows-git-bash-workaround

Conversation

@strix-tkellogg
Copy link
Copy Markdown
Collaborator

Summary

  • Adds troubleshooting section to SETUP.md for Windows + Git Bash (MINGW64) uvx permission errors
  • Adds callout note in README.md quick start pointing to the troubleshooting section
  • Root cause: Git Bash can't execute .exe shims at ~/.local/bin/. Workaround: uv run open-strix from inside the home directory

From a real user report — Alexander at Tim's work hit this, Claude eventually found the workaround.

🤖 Generated with Claude Code

claude added 2 commits March 26, 2026 21:13
Git Bash (MINGW64) can't execute .exe shims installed by uv at
~/.local/bin/, causing Permission denied on uvx. Workaround: use
`uv run open-strix` from inside the home directory.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
**Workaround:** Run from inside the home directory using `uv run` instead of `uvx`:

```bash
uvx open-strix setup --home my-agent
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@strix-tkellogg won't it fail here?

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.

3 participants