Skip to content

Add native Windows installer and documentation - #8

Open
nsxdavid wants to merge 5 commits into
release/0.2.5829from
docs/windows-native-install
Open

Add native Windows installer and documentation#8
nsxdavid wants to merge 5 commits into
release/0.2.5829from
docs/windows-native-install

Conversation

@nsxdavid

@nsxdavid nsxdavid commented Jul 14, 2026

Copy link
Copy Markdown
Owner

Summary

  • add a native Windows PowerShell installer for the published x86_64 release asset
  • verify the downloaded binary against the release SHA256 checksums before installation
  • document the one-line Windows install and Windows MCP client paths
  • correct the Bash installer so native Windows users are directed to PowerShell without continuing into a Linux/macOS download
  • align npm and website install documentation with shipped Windows support

Why

codedb now publishes codedb-windows-x86_64.exe, but the primary installation documentation still described codedb as macOS/Linux-only or directed Windows users to WSL. This made the shipped native binary difficult to discover and install safely.

Validation

  • Windows PowerShell 5.1 installer downloaded release 0.2.5830, verified SHA256, installed, and returned codedb 0.2.5830
  • exact irm ... | iex execution shape validated against the checked-out installer
  • native Windows MCP E2E passed 20/20 scenarios
  • local packed codedeebee 0.2.5830 package installed and ran the Windows binary
  • Bash syntax and simulated Windows dispatch passed for all tracked shell-installer copies
  • PowerShell parser and git diff --check passed

Notes

  • The public npm latest tag was still 0.2.5823 during validation, so the root README does not yet recommend npm for Windows.
  • Tracked website/dist outputs are updated alongside their website sources.
  • No MCP runtime behavior is changed.

Summary by CodeRabbit

  • New Features
    • Added a native Windows x86_64 installer with SHA-256 verification and optional PATH configuration.
    • Added Windows support guidance for npm and MCP client setup.
    • Installers now provide platform-specific instructions and avoid running the wrong installer on Windows.
  • Documentation
    • Clarified installation, upgrades, repairs, CLI behavior, automatic MCP registration, and troubleshooting.
    • Added Windows cross-compilation instructions and updated supported-platform information.
    • Updated privacy and website content to reflect Windows support and release-download activity.

@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown

Review Change Stack

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 4301997a-6650-4015-9168-bf90d7912c4d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

This PR adds a checksum-verifying native Windows PowerShell installer, redirects Windows users from Bash installers, documents Windows npm and MCP usage, and updates installation, update, troubleshooting, metadata, and network-access guidance.

Changes

Windows support

Layer / File(s) Summary
Native PowerShell installer
install/install.ps1
Adds Windows x64 validation, release resolution, SHA-256 verification, staged installation, optional PATH updates, post-install verification, and cleanup.
Platform detection routing
install/install.sh, website/app/install_script.sh
Routes Windows users to the PowerShell installer and treats the Windows detection status as a successful no-op.
npm Windows support
npm/README.md
Documents Windows MCP configuration with npx.cmd, npm-based updates, and native binary requirements when postinstall is skipped.
Platform installation and MCP guidance
README.md, docs/mcp.md, website/app/*
Updates platform-specific installation, MCP registration and configuration, troubleshooting, Windows build targets, structured metadata, and network-access descriptions.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Poem

A rabbit checks each hash with care,
PowerShell hops through Windows air.
MCP tools bloom, docs paths align,
“codedb.exe” now crosses the line.
Clean installs leave no crumbs behind.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: adding a native Windows installer and updating related documentation.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@nsxdavid

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e306c830e5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread install/install.ps1

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
install/install.ps1 (1)

101-104: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Handle in-use binary replacements on Windows.

If codedb.exe is currently running (e.g., as a background MCP server), Move-Item -Force will fail with a file-in-use error because Windows locks executing binaries.

To allow seamless updates without requiring the user to stop the process first, you can leverage the fact that Windows allows renaming a running executable:

♻️ Proposed fix
   Copy-Item -LiteralPath $downloadedBinary -Destination $stagedPath -Force
   Unblock-File -LiteralPath $stagedPath -ErrorAction SilentlyContinue
+  if (Test-Path -LiteralPath $targetPath) {
+    Move-Item -LiteralPath $targetPath -Destination "$targetPath.old" -Force -ErrorAction SilentlyContinue
+  }
   Move-Item -LiteralPath $stagedPath -Destination $targetPath -Force
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@install/install.ps1` around lines 101 - 104, Update the installation
replacement flow around Copy-Item, Unblock-File, and Move-Item so replacing a
running codedb.exe succeeds on Windows. Use a rename-based replacement strategy
that leverages Windows’ ability to rename an executing binary, while preserving
the existing staging and overwrite behavior for normal installations.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@npm/README.md`:
- Around line 73-90: Update the root README reference in the Windows support
section to use the repository’s absolute GitHub URL with the existing `#windows`
anchor, replacing the relative ../README.md link while preserving the
surrounding instructions.

---

Nitpick comments:
In `@install/install.ps1`:
- Around line 101-104: Update the installation replacement flow around
Copy-Item, Unblock-File, and Move-Item so replacing a running codedb.exe
succeeds on Windows. Use a rename-based replacement strategy that leverages
Windows’ ability to rename an executing binary, while preserving the existing
staging and overwrite behavior for normal installations.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ab78c4b9-92cc-492e-8773-2f159bea83de

📥 Commits

Reviewing files that changed from the base of the PR and between b6b4f7f and e306c83.

⛔ Files ignored due to path filters (3)
  • website/dist/install.sh is excluded by !**/dist/**
  • website/dist/privacy.html is excluded by !**/dist/**
  • website/dist/quickstart.html is excluded by !**/dist/**
📒 Files selected for processing (9)
  • README.md
  • docs/mcp.md
  • install/install.ps1
  • install/install.sh
  • npm/README.md
  • website/app/install_script.sh
  • website/app/layout.zig
  • website/app/privacy.zig
  • website/app/quickstart.zig

Comment thread npm/README.md
@nsxdavid

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a0cf745d82

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread install/install.ps1
@nsxdavid

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep it up!

Reviewed commit: 716435defe

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@nsxdavid

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@nsxdavid
nsxdavid force-pushed the docs/windows-native-install branch from 716435d to d321e16 Compare July 15, 2026 01:15
@nsxdavid
nsxdavid changed the base branch from release/0.2.5829 to main July 15, 2026 01:16
@github-actions

Copy link
Copy Markdown

👋 Thanks for the contribution! Quick heads-up: this repo lands changes on the current release/* branch, not main.

Please retarget this PR via Edit → base branch to the active release/* branch shown in the repository branch list.

(Automated hint — reply here if you need a hand.)

@nsxdavid
nsxdavid force-pushed the docs/windows-native-install branch from d321e16 to 716435d Compare July 15, 2026 01:22
@nsxdavid
nsxdavid changed the base branch from main to release/0.2.5829 July 15, 2026 01:22
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.

1 participant