Skip to content

Tracking: macOS install story #55

Description

@gregjkal

Tracking issue for the macOS install story. Findings come from building the Workshop DMG from master (3121cdd, workspace 0.3.0) on Apple Silicon, macOS 26, installing it with a scratch HOME, and checking the published download, on 2026-09-17. Each item below has its own issue with a concrete "done means"; this one closes when they do.

Work items

Not filed

  • The 0.2.0 app showing no window, no listener, and no log when launched without a gateway. Superseded by Release workshop-v0.3.0 and mark support archives pre-release #56; if the behavior persists on a 0.3.0 Workshop-only install, file it then against the guide's "error that names both remedies" promise.
  • The generated gateway.toml having no chat model. The in-app cloud-model flow on master may already cover the first-chat path; nobody has run it on a clean install yet. File once someone does and can say what is actually missing.
  • Moving the release workflow's hand cp of the sidecar onto tools/stage-gateway-sidecar.mjs. Cleanup, not user-facing; do it when someone next touches the workflow.

Baseline

The locally built 0.3.0 DMG is correct: app plus Applications symlink plus custom background and volume icon, both binaries at 0.3.0, the in-process server listening within 5 s, the sibling gateway launching and writing its discovery file, the speech engine loading, and the gateway outliving the window as documented. The problems above are all around that working core.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions