Skip to content

docs(install): explain the working Windows PowerShell setup - #181

Merged
redox merged 1 commit into
altertable-ai:mainfrom
albert20260301:fix/149-windows-installation
Nov 8, 2026
Merged

redox merged 1 commit into
altertable-ai:mainfrom
albert20260301:fix/149-windows-installation

Conversation

@albert20260301

@albert20260301 albert20260301 commented Nov 8, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Addresses #149 with the documented Windows installation route requested in the report.

  • Limit the shell installer recommendation to macOS/Linux.
  • Give PowerShell users Bun's official Windows installer, a terminal/PATH refresh, Get-Command bun.exe, and the npm CLI install/verification commands.
  • Explain why npm's bun.cmd/bun.ps1 shims are not a substitute for bun.exe, and that Node cannot execute the Bun bundle.
  • State that current standalone release assets do not include Windows.

This is a documentation correction, not a new Windows binary or launcher implementation.

Verification

  • Full bun run check passes with pinned Bun 1.4.4: 866 unit tests, 157 black-box tests, 42 browser tests, types/lint/format/generated checks, both knip checks, and packed npm consumer smoke.
  • Read the final documentation diff and checked whitespace. No runtime code changed; the PowerShell installation itself was not executed on this Linux host.

CI status

Canonical repository/integration checks, cross-platform user-directory checks, and minimum-Bun runtime verification pass. CodeQL initialization failed before analysis with repeated HTTP 504s downloading the CLI bundle; a human retry is requested in the PR thread. All four native compilation/smoke checks also passed.

@albert20260301

Copy link
Copy Markdown
Contributor Author

@francoischalifour, please retry the failed CodeQL job. Initialization failed before analysis because downloading the CodeQL 2.27.4 bundle returned repeated HTTP 504 responses. The same endpoint subsequently worked for #182, whose CodeQL analysis passed.

The canonical repository/integration, Linux/macOS/Windows user-directory checks, and minimum Bun runtime checks passed. I cannot rerun Actions jobs under my maintainer permissions. If the retry has not happened by November 15, I will leave the PR open without another ping.

@redox
redox merged commit c0a5cfc into altertable-ai:main Nov 8, 2026
17 of 18 checks passed
@albert20260301
albert20260301 deleted the fix/149-windows-installation branch November 8, 2026 12:51
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.

2 participants