Skip to content

Conversation

dhofheinz
Copy link

Adds troubleshooting section to WINDOWS.md covering common Windows-specific issues that have been hitting users.

Currently WINDOWS.md only has dev setup (32 lines). This adds 151 lines covering real operational issues reported across multiple GitHub issues.

Issues Addressed

Issue #294: "Failed to determine latest version"

  • Added section explaining network/firewall causes
  • Solutions: proxy configuration, GitHub access verification, cache clearing
  • Verified against npm-app/release/index.js:309-312 error handling

Issue #274: Git commands fail on Windows

  • Added section explaining cmd.exe vs bash limitations
  • Solutions: Git Bash usage, WSL recommendations
  • Referenced npm-app/src/terminal/background.ts:31 shell selection logic

Issue #299: Login browser window fails + confusing error message

  • Added section for "start" command not found in Git Bash
  • Solutions: manual URL copy/paste, native terminal recommendations
  • Added clarification that "Update available: error" is not actually an error
  • Referenced npm-app/src/client.ts:607 browser opening logic

All solutions are configuration/workflow guidance with no code changes needed.

Fixes #294, #274, #299

Addresses common Windows-specific issues reported in CodebuffAI#294, CodebuffAI#274, CodebuffAI#299:
- Network/proxy configuration for version check failures
- Git Bash/WSL recommendations for git command compatibility
- Browser login workarounds for Git Bash users
- Clarification on "Update available: error" message

All solutions are configuration/workflow guidance with no code changes.
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.

windows failed to determine latest version

1 participant