Skip to content

docs(macos): sandboxed vs non-sandboxed builds and the minimum macOS version #1591

Closed

Description

@ZhuchkaTriplesix

Problem

The shipped macOS app is one of two different programs depending on CI secrets:

  • Signed builds use ReleaseSigned.entitlements: no App Sandbox, hardened runtime.
  • Without MACOS_* secrets (forks, local flutter build macos) the Xcode project's Release.entitlements applies: App Sandbox on, only network.client/server and files.user-selected.read-write.

In the sandboxed build ~/.querya, extension processes (sandbox-exec inside a sandbox), in-place updates into /Applications, the MCP socket and previously chosen SQLite file paths (no security-scoped bookmarks) do not behave like the signed build. docs/macos-signing.md mentions it; README and the contributor docs do not.

Also MACOSX_DEPLOYMENT_TARGET = 10.15 in all configurations while the docs target macOS 14+ for ProMotion; the minimum is not checked against the plugins' requirements.

Tasks

  • Decide: ship the unsigned build without the sandbox too, or document the limitations in README / CONTRIBUTING.
  • Align and document the minimum macOS version.

Activity

  1. added
    documentationImprovements or additions to documentation
    P3Low priority / Polish & Enhancements
    on Oct 14, 2026
  2. ZhuchkaTriplesix commented on Oct 25, 2026

    @ZhuchkaTriplesix
    MemberAuthor

    Fixed on dev by c811908: docs(macos): installing the unsigned build on macOS 14 and 15+, App Translocation, and the minimum macOS versi. It reaches main with the next dev to main merge (closed after checking the code and its tests).

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

    P3Low priority / Polish & EnhancementsdocumentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions