Skip to content

fix: use redirect-free install.ps1 url on windows powershell 5.1#182

Merged
0xKT merged 1 commit into
mainfrom
fix/windows_ps51_install_redirect
Jul 22, 2026
Merged

fix: use redirect-free install.ps1 url on windows powershell 5.1#182
0xKT merged 1 commit into
mainfrom
fix/windows_ps51_install_redirect

Conversation

@0xKT

@0xKT 0xKT commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

The short URL raven.evermind.ai/install.ps1 is served as an HTTP 308 (Permanent Redirect) to GitHub. Windows PowerShell 5.1 (the version built into Windows, whose irm runs on .NET Framework) does not follow 308 redirects and fails with Permanent Redirect, blocking a fresh Windows user at the very first install step. PowerShell 7+ follows 308 and works. The site host (Framer) cannot be configured to emit 301/302, so the fix points Windows users at the redirect-free raw URL.

  • README.md / README.zh-CN.md: keep the branded short URL as the default and add the redirect-free command for Windows PowerShell 5.1 right below it.
  • raven/channels/manager.py: the Windows missing-dependency hint used the same 308 short URL, so a PS 5.1 user copying it would hit the identical error; it now uses the raw URL.
  • tests/test_channels_manager.py: assert the Windows hint points at the raw host.

install.sh (macOS/Linux) is unchanged: curl -fsSL follows 308, so it is unaffected.

Type

  • Fix

Verification

  • uv run pytest tests/test_channels_manager.py -q -> 22 passed

  • bash .claude/scripts/preflight_ci.sh -> all checks passed (commitlint, check_commit_messages, large-files, pre-commit, ruff lint/format, focused pytest 59 passed)

  • curl -sSI https://raw.githubusercontent.com/EverMind-AI/Raven/refs/heads/main/install.ps1 -> HTTP 200

  • Relevant tests pass locally

  • Relevant lint / type checks pass locally

  • User-facing docs or screenshots are updated when needed

Risk

The raw URL is pinned to refs/heads/main, which matches the current Framer redirect target, so behavior is equivalent to the short URL and no new coupling is introduced. A follow-up will add a cross-platform command to install a missing channel dependency, so the manager hint no longer needs per-platform install commands.

  • Security impact considered
  • Backward compatibility considered
  • Rollback path is clear for risky changes

Related Issues

Fixes #148

The short URL raven.evermind.ai/install.ps1 is served as an HTTP 308
redirect. Windows PowerShell 5.1 (irm, on .NET Framework) does not follow
308 and fails with "Permanent Redirect", blocking install. Point Windows
users at the redirect-free raw URL instead.

- README / README.zh-CN: add the PS 5.1 fallback command below the default
- channels manager: same short link in the Windows missing-dependency hint
  now uses the raw URL
- tests: assert the Windows hint points at the raw host

Co-authored-by: Claude (claude-opus-4-8) <noreply@anthropic.com>
@0xKT
0xKT requested a review from arelchan July 22, 2026 11:36
@0xKT
0xKT merged commit 33a0827 into main Jul 22, 2026
8 checks passed
@0xKT
0xKT deleted the fix/windows_ps51_install_redirect branch July 22, 2026 11:56
@0xKT 0xKT mentioned this pull request Jul 22, 2026
3 tasks
0xKT added a commit that referenced this pull request Jul 22, 2026
## Summary

Bump version from 0.1.7 to 0.1.8. Release commit only touches
`pyproject.toml` and `uv.lock` (kept in sync via `uv lock`).

Changes bundled into this release since v0.1.7:

- feat(importer): cold-start import from other AI tools with EverOS HTTP
backend (#170)
- fix(build): pin locked dependency versions in installers (#185)
- fix(cli): stop blank api key exiting deep_research prompt (#184)
- fix: use redirect-free install.ps1 url on windows powershell 5.1
(#182)
- fix(tui): brighten selection highlight for readability (#175)
- fix(commitlint): align subject-case with conventional-commits standard
(#187)

## Type

- [x] Other

## Verification

- [x] Relevant lint / type checks pass locally

```
python3 scripts/check_commit_messages.py origin/main..HEAD  # exit 0
git diff --stat  # pyproject.toml + uv.lock, 1 line each
```

## Risk

- [x] Backward compatibility considered

Version bump only; no source changes.

## Related Issues

N/A

Co-authored-by: Claude (claude-opus-4-8) <noreply@anthropic.com>
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.

fix: cannot install Raven in Windows via powershell 5.1

2 participants