feat(gateway,cli): windows compilation support by araza008 · Pull Request #2496 · NVIDIA/OpenShell

araza008 · 2026-07-27T14:43:51Z

Summary

compile the OpenShell gateway and CLI natively on Windows MSVC for x86-64 and arm64. It is build support only. It does not add functional Windows support for MXC, the sandbox supervisor, or Windows services.

Related Issue

Changes

adds windows mise tasks
supports bundled-z3 with optional system z3
gates unix-only dependencies so the geteway and cli compile on windows
adds linting and pre-commit tasks

Testing

mise run --skip-tools windows:build:x64
mise run --skip-tools windows:build:arm64

Checklist

Follows Conventional Commits
Commits are signed off (DCO)
Architecture docs updated (if applicable)

copy-pr-bot · 2026-07-27T14:43:55Z

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

github-actions · 2026-07-27T14:44:02Z

All contributors have signed the DCO ✍️ ✅
_{Posted by the DCO Assistant Lite bot.}

araza008 · 2026-07-27T17:33:14Z

I have read the DCO document and I hereby sign the DCO.

jamieknvidia · 2026-07-27T23:12:18Z

I have read the DCO document and I hereby sign the DCO.

drew · 2026-07-28T05:03:59Z

/ok to test d0bcaca

gburachas · 2026-07-28T16:14:00Z

I have read the DCO document and I hereby sign the DCO.

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Akber Raza <akberr@nvidia.com>

…ove build logic Signed-off-by: Akber Raza <akberr@nvidia.com>

… with bundled Z3 features Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Giedrius Burachas <gburachas@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

…re-specific subdirectories Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Akber Raza <akberr@nvidia.com>

…ation and scripts Signed-off-by: Akber Raza <akberr@nvidia.com>

Why: windows-msvc-build-design.mdx is a design document ("design decisions for the native Windows MSVC build lane"), but it lived in the published, user-facing docs/reference/ tree. Per AGENTS.md (Documentation) and architecture/README.md ("rfc/ vs architecture/"), design content belongs in architecture/ (or rfc/), not in published reference. It also shared Fern sidebar "position: 6" with the MXC compute-driver design page, colliding in the Reference nav ordering. What: - Move docs/reference/windows-msvc-build-design.mdx -> architecture/windows-msvc-build.md. - Strip the Fern publish frontmatter and add a plain H1, matching the other architecture docs. - Register it in the architecture doc index in architecture/README.md. - Repoint the inbound references (build-openshell-mxc-windows skill + reference, implement-openshell-mxc-driver skill) to the new path. With both design pages moved out of docs/reference/, the duplicate position-6 sidebar collision is resolved. Signed-off-by: Akber Raza <akberr@nvidia.com>

…est exclusion list Signed-off-by: Akber Raza <akberr@nvidia.com> # Conflicts: # tasks/scripts/windows-msvc.ps1

openshell-gateway-interceptors failed to compile on Windows (E0432: no UnixStream in tokio::net), breaking any Windows build of openshell-server (which depends on it unconditionally). The connect_unix_endpoint fn was already #[cfg(unix)]-gated, but the imports it uses (UnixStream, TokioIo, Uri, service_fn) were left ungated. Gate those four imports with #[cfg(unix)] too. No behavior change on unix; Windows now compiles (no errors, no unused-import warnings). Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

… with bundled Z3 features Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Giedrius Burachas <gburachas@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

…re-specific subdirectories Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Akber Raza <akberr@nvidia.com>

…ation and scripts Signed-off-by: Akber Raza <akberr@nvidia.com>

Why: windows-msvc-build-design.mdx is a design document ("design decisions for the native Windows MSVC build lane"), but it lived in the published, user-facing docs/reference/ tree. Per AGENTS.md (Documentation) and architecture/README.md ("rfc/ vs architecture/"), design content belongs in architecture/ (or rfc/), not in published reference. It also shared Fern sidebar "position: 6" with the MXC compute-driver design page, colliding in the Reference nav ordering. What: - Move docs/reference/windows-msvc-build-design.mdx -> architecture/windows-msvc-build.md. - Strip the Fern publish frontmatter and add a plain H1, matching the other architecture docs. - Register it in the architecture doc index in architecture/README.md. - Repoint the inbound references (build-openshell-mxc-windows skill + reference, implement-openshell-mxc-driver skill) to the new path. With both design pages moved out of docs/reference/, the duplicate position-6 sidebar collision is resolved. Signed-off-by: Akber Raza <akberr@nvidia.com>

…est exclusion list Signed-off-by: Akber Raza <akberr@nvidia.com> # Conflicts: # tasks/scripts/windows-msvc.ps1

openshell-gateway-interceptors failed to compile on Windows (E0432: no UnixStream in tokio::net), breaking any Windows build of openshell-server (which depends on it unconditionally). The connect_unix_endpoint fn was already #[cfg(unix)]-gated, but the imports it uses (UnixStream, TokioIo, Uri, service_fn) were left ungated. Gate those four imports with #[cfg(unix)] too. No behavior change on unix; Windows now compiles (no errors, no unused-import warnings). Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Akber Raza <akberr@nvidia.com>

Signed-off-by: Shailendra Singh <shailendras@nvidia.com>

Signed-off-by: Akber Raza <akberr@nvidia.com>

…nShell into windows_compilation

Signed-off-by: Akber Raza <akberr@nvidia.com>

araza008 · 2026-08-04T08:59:36Z

/ok to test 60c2340

araza008 requested review from a team, derekwaynecarr, maxamillion and mrunalp as code owners July 27, 2026 14:43

drew changed the title ~~Windows compilation~~ feat(gateway,cli): windows compilation support Jul 28, 2026

shailendra-nv and others added 19 commits July 28, 2026 18:07

chore(windows): gate Unix-only workspace code for MSVC

d859284

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

feat(windows): stub unsupported compute drivers

e4b7768

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

ci(windows): add MSVC mise build lane

c78c1a0

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

docs(windows): document MSVC build-only design

2e1fc1c

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

docs(agent): add Windows MSVC build skill

80a9a11

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

feat(windows): add Windows build support

f411ac2

Signed-off-by: Akber Raza <akberr@nvidia.com>

refactor(windows): consolidate Windows-specific dependencies and impr…

e8a1226

…ove build logic Signed-off-by: Akber Raza <akberr@nvidia.com>

feat(windows): add libclang path resolution and update cargo commands…

cd12c15

… with bundled Z3 features Signed-off-by: Akber Raza <akberr@nvidia.com>

chore(tooling): lock Windows tool artifacts

7541fb4

Signed-off-by: Giedrius Burachas <gburachas@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

feat(windows): enhance libclang path resolution to support architectu…

de33ded

…re-specific subdirectories Signed-off-by: Akber Raza <akberr@nvidia.com>

Fix Windows dependency gating after sync merge

5baaa3f

Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(z3): update Z3 header path requirements in Windows build document…

3669d79

…ation and scripts Signed-off-by: Akber Raza <akberr@nvidia.com>

remove openshell-supervisor-network from unsupported driver package t…

d95df2f

…est exclusion list Signed-off-by: Akber Raza <akberr@nvidia.com> # Conflicts: # tasks/scripts/windows-msvc.ps1

feat(windows): add native ARM64 test support

7809c78

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(mise): skip Skaffold on Windows

7865116

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): harden ARM64 toolchain discovery

a8e78bb

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): scope ARM64 toolchain preflight

7ee6ebb

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

araza008 and others added 29 commits August 3, 2026 13:52

feat(windows): add libclang path resolution and update cargo commands…

1ae2500

… with bundled Z3 features Signed-off-by: Akber Raza <akberr@nvidia.com>

chore(tooling): lock Windows tool artifacts

b64744b

Signed-off-by: Giedrius Burachas <gburachas@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

feat(windows): enhance libclang path resolution to support architectu…

3f86a83

…re-specific subdirectories Signed-off-by: Akber Raza <akberr@nvidia.com>

Fix Windows dependency gating after sync merge

615d8dc

Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(z3): update Z3 header path requirements in Windows build document…

b014499

…ation and scripts Signed-off-by: Akber Raza <akberr@nvidia.com>

remove openshell-supervisor-network from unsupported driver package t…

1f66e0b

…est exclusion list Signed-off-by: Akber Raza <akberr@nvidia.com> # Conflicts: # tasks/scripts/windows-msvc.ps1

feat(windows): add native ARM64 test support

7f5d29f

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(mise): skip Skaffold on Windows

af4570f

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): harden ARM64 toolchain discovery

f3adef3

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): scope ARM64 toolchain preflight

6d22713

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): restore compatibility after GitHub sync

4b93132

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): avoid rate-limited Z3 source lookup

6fa3d2c

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(mise): skip Helm checks on Windows

8672961

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): support repository pre-commit checks

893eb93

Signed-off-by: Shailendra Singh <shailendras@nvidia.com> Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): stabilize native MSVC validation

ad359cb

Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): harden shared Z3 source cache

79f21de

Signed-off-by: Shailendra Singh <shailendras@nvidia.com>

fix(windows): avoid leaking MSVC flags into clang-cl

db4a352

Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): complete ARM64 migration audit

dedeb4a

Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): restore ARM64 Ninja discovery

9dc3723

Signed-off-by: Akber Raza <akberr@nvidia.com>

refactor(windows): separate platform crate roots

e05987f

Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): restore proto include cfg gating

e02427f

Signed-off-by: Akber Raza <akberr@nvidia.com>

refactor: address lint errors

e47e154

fix(windows): add preflight check for proxy auth file path

3eb2803

docs(windows): update GitHub checkout guidance

187f480

Signed-off-by: Akber Raza <akberr@nvidia.com>

fix(windows): restore CI after dependency updates

2a6547f

Signed-off-by: Akber Raza <akberr@nvidia.com>

Merge branch 'windows_compilation' of https://github.com/araza008/Ope…

bbaf79d

…nShell into windows_compilation

fix(mise): repair Windows sccache lock entry

60c2340

Signed-off-by: Akber Raza <akberr@nvidia.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(gateway,cli): windows compilation support - #2496

feat(gateway,cli): windows compilation support#2496
araza008 wants to merge 97 commits into
NVIDIA:mainfrom
araza008:windows_compilation

araza008 commented Jul 27, 2026 •

edited

Loading

Uh oh!

copy-pr-bot Bot commented Jul 27, 2026

Uh oh!

github-actions Bot commented Jul 27, 2026 •

edited

Loading

Uh oh!

araza008 commented Jul 27, 2026

Uh oh!

jamieknvidia commented Jul 27, 2026

Uh oh!

drew commented Jul 28, 2026

Uh oh!

gburachas commented Jul 28, 2026

Uh oh!

araza008 commented Aug 4, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

16 participants

Uh oh!

Conversation

araza008 commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Related Issue

Changes

Testing

Checklist

Uh oh!

copy-pr-bot Bot commented Jul 27, 2026

Uh oh!

github-actions Bot commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

araza008 commented Jul 27, 2026

Uh oh!

jamieknvidia commented Jul 27, 2026

Uh oh!

drew commented Jul 28, 2026

Uh oh!

gburachas commented Jul 28, 2026

Uh oh!

araza008 commented Aug 4, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

16 participants

araza008 commented Jul 27, 2026 •

edited

Loading

github-actions Bot commented Jul 27, 2026 •

edited

Loading