Skip to content

Add Windows ZCode discovery and app-server launch support #5074

Description

@jzhishu

What problem are you trying to solve?

PR #4819 adds the first pass of ZCode support for Open Design, scoped to the verified macOS install path.

On macOS, OD can discover or let users select ZCode.app, then launch the bundled app-server entrypoint:

ZCode.app/Contents/Resources/glm/zcode.cjs app-server

Windows support is not included yet because the Windows install layout and app-server entrypoint have not been verified. Without that follow-up, Windows users may not be able to use ZCode from OD even after the macOS integration lands.

Describe the solution you'd like

Add Windows support for ZCode discovery and app-server launch.

This should verify the Windows install layout, identify the correct app-server entrypoint, and wire that path into OD's runtime detection, connection test, and run flow.

Acceptance criteria:

  • OD can auto-detect a standard Windows ZCode install.
  • OD can launch ZCode app-server on Windows.
  • ZCode connection test works on Windows.
  • ZCode runs can stream events into OD chat on Windows.
  • If manual selection is needed, Settings exposes a Windows-appropriate picker.
  • Tests cover Windows path resolution without depending on a real local install.

Alternatives you've considered

I considered keeping Windows support in #4819, but that PR is already a complete macOS-scoped implementation. The Windows install layout and app-server entrypoint still need separate verification, so handling it as a follow-up should keep the current PR reviewable and avoid guessing at Windows paths.

Additional context

Related:

Things to verify:

  • Where ZCode installs on Windows.
  • Whether Windows ships a public CLI, an .exe, a .cmd, or a bundled zcode.cjs.
  • The Windows equivalent of the app-server launch command.
  • Where ZCode stores saved provider/model configuration on Windows.
  • Whether the existing ZCode saved config reader works unchanged on Windows.
  • What Settings UX should look like on Windows.

Would you be willing to contribute a PR?

Yes, I can take this on

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestneeds-product-directionAwaiting product direction review (see OpenDesign roadmap)

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions