Ship Windows+Linux only, fix missing Windows artifact, direct macOS to build from source

Author: TechyCSR

.github/workflows/release.yml

@@ -21,7 +21,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
+        os: [ubuntu-latest, windows-latest]
         include:
           - os: ubuntu-latest
             script: linux
@@ -32,11 +32,6 @@ jobs:
             script: win
             artifact_glob: |
               dist/*.exe
-          - os: macos-latest
-            script: mac
-            artifact_glob: |
-              dist/*.dmg
-              dist/*.zip
 
     steps:
       - name: Checkout
@@ -185,11 +180,15 @@ jobs:
           | Platform | File | Notes |
           |---|---|---|
           | **Windows** | `OpenCluely-Setup-*.exe` | NSIS installer — installs app + adds to Start Menu |
-          | **macOS (Apple Silicon)** | `*-arm64.dmg` | M1/M2/M3/M4 Macs |
-          | **macOS (Intel)** | `*-x64.dmg` | Older Intel Macs |
           | **Linux** | `*.deb` | Debian/Ubuntu — auto-pulls system deps (Python, ffmpeg, GTK) |
           | **Linux** | `*.AppImage` | Universal — no install, just `chmod +x` and run |
 
+          > **macOS:** no pre-built build is shipped. The app is unsigned/un-notarized, so macOS Gatekeeper blocks it as "damaged". Run OpenCluely from source instead:
+          > ```bash
+          > git clone https://github.com/TechyCSR/OpenCluely && cd OpenCluely && ./setup.sh
+          > ```
+          > Requires Node.js 18+. See the [README](https://github.com/TechyCSR/OpenCluely#quick-start) for details.
+
           ## First Run
 
           On first launch, OpenCluely opens the **Settings** window automatically for your **Google Gemini API key**.
@@ -228,21 +227,15 @@ jobs:
       - name: Flatten artifacts
         run: |
           mkdir -p release
-          # Pick only the primary installer per platform (max 2-3 per
-          # platform). This intentionally drops:
+          # Pick only the primary installer per platform. This intentionally drops:
           #   - Windows portable EXE (we ship the NSIS installer)
-          #   - macOS .zip (the DMG is the canonical macOS installer)
           #   - .blockmap files (electron-updater diff metadata)
           #   - latest-*.yml (electron-updater channel metadata)
           #   - Source archives (GitHub auto-generates these from the tag)
           #
           # The order below is the order files appear in the release page.
           find artifacts -type f -name 'OpenCluely-Setup-*.exe' \
             -exec cp -v {} release/ \;
-          # macOS DMGs — electron-builder omits the arch suffix for the
-          # default (x64) arch, so we keep every OpenCluely-*.dmg.
-          find artifacts -type f -name 'OpenCluely-*.dmg' \
-            -exec cp -v {} release/ \;
           find artifacts -type f -name 'opencluely_*_amd64.deb' \
             -exec cp -v {} release/ \;
           find artifacts -type f -name '*.AppImage' \

README.md

@@ -40,7 +40,7 @@ It is free and open source. Processing stays on your machine, and the only thing
 - **Session memory.** The whole conversation is remembered, so follow-ups, edge cases, and optimizations keep their context.
 - **Language aware.** Tailored answers for C++, C, Python, Java, and JavaScript.
 - **Stealthy by design.** Runs under ordinary system names, ships with no telemetry, and keeps your session local.
-- **Cross platform.** Windows, macOS on Apple Silicon and Intel, and Linux through .deb and AppImage builds.
+- **Cross platform.** Pre-built installers for Windows and Linux (.deb and AppImage). macOS runs from source in one command.
 
 ## Download
 
@@ -49,12 +49,12 @@ Pre-built installers are published with every release. These links always point
 | Platform | File | Notes |
 |---|---|---|
 | Windows | [Setup .exe](https://github.com/TechyCSR/OpenCluely/releases/latest) | NSIS installer. Adds a Start Menu shortcut. |
-| macOS (Apple Silicon) | [arm64 .dmg](https://github.com/TechyCSR/OpenCluely/releases/latest) | For M1, M2, M3, and M4 Macs. |
-| macOS (Intel) | [x64 .dmg](https://github.com/TechyCSR/OpenCluely/releases/latest) | For older Intel based Macs. |
 | Linux (Debian or Ubuntu) | [.deb](https://github.com/TechyCSR/OpenCluely/releases/latest) | Pulls system deps automatically (Python, ffmpeg, GTK). |
 | Linux (universal) | [.AppImage](https://github.com/TechyCSR/OpenCluely/releases/latest) | No install. Run `chmod +x` then launch. |
 
-Every build is produced automatically on GitHub Actions across all three platforms and ships with SHA-256 checksums. Each release also lists the full set of commits it includes.
+> **macOS:** there is no pre-built download. The app is unsigned and un-notarized, so macOS Gatekeeper blocks it as "damaged and can't be opened." Run OpenCluely from source instead — see [Quick start](#quick-start). It is a one-line `./setup.sh` once Node.js is installed.
+
+Every build is produced automatically on GitHub Actions and ships with SHA-256 checksums. Each release also lists the full set of commits it includes.
 
 The website at [opencluely.techycsr.dev](https://opencluely.techycsr.dev) detects your operating system and offers the right installer directly.
 
@@ -85,6 +85,7 @@ If you would rather build from source, three steps are all it takes.
 
 - On Windows, use Git Bash (included with Git for Windows) or WSL to run `setup.sh`.
 - On macOS and Linux, your normal terminal works.
+- **macOS users must build from source** (steps above) — there is no pre-built `.dmg`. Because the app is unsigned, a downloaded build would be blocked by Gatekeeper as "damaged"; running from source avoids that entirely.
 - No manual `npm` commands are needed. The script handles everything.
 
 ### Setup script options

package.json

@@ -157,7 +157,8 @@
       "createStartMenuShortcut": true,
       "perMachine": false,
       "include": "scripts/post-install-nsis.nsh",
-      "deleteAppDataOnUninstall": false
+      "deleteAppDataOnUninstall": false,
+      "artifactName": "OpenCluely-Setup-${version}.${ext}"
     },
     "dmg": {
       "title": "OpenCluely Interview Assistant",

webapp/index.html

@@ -346,7 +346,7 @@ <h2 class="section-title">Questions, answered</h2>
           </details>
           <details>
             <summary>Which platforms are supported?<svg class="ic chev"><use href="#i-arrow"/></svg></summary>
-            <p>Windows, macOS on both Apple Silicon and Intel, and Linux through .deb and AppImage builds. Every release is built automatically across all three on GitHub Actions.</p>
+            <p>Windows and Linux (.deb and AppImage) ship as pre-built installers, built automatically on GitHub Actions with every release. macOS is not pre-built &mdash; the unsigned app is blocked by Gatekeeper, so on macOS you run it from source with a one-line <code>./setup.sh</code>.</p>
           </details>
           <details>
             <summary>Is my data collected?<svg class="ic chev"><use href="#i-arrow"/></svg></summary>

webapp/script.js

@@ -110,22 +110,15 @@
     var ua = (navigator.userAgent || '').toLowerCase();
     var plat = (navigator.platform || '').toLowerCase();
     if (ua.indexOf('windows') !== -1 || plat.indexOf('win') !== -1) return 'windows';
-    if (ua.indexOf('mac') !== -1 || plat.indexOf('mac') !== -1) {
-      // Apple Silicon is the default for new Macs; cannot read arch reliably.
-      return 'macos-arm';
-    }
+    if (ua.indexOf('mac') !== -1 || plat.indexOf('mac') !== -1) return 'macos';
     if (ua.indexOf('linux') !== -1 || ua.indexOf('x11') !== -1) return 'linux-deb';
     return null;
   }
 
-  /* ---------- Platforms ---------- */
+  /* ---------- Platforms (pre-built: Windows + Linux only) ---------- */
   var PLATFORMS = [
     { id: 'windows', label: 'Windows', icon: 'i-windows', note: 'NSIS installer. Adds a Start Menu shortcut.',
       match: function (n) { return n.endsWith('.exe') && n.indexOf('blockmap') === -1; } },
-    { id: 'macos-arm', label: 'macOS, Apple Silicon', icon: 'i-apple', note: 'For M1, M2, M3 and M4 Macs.',
-      match: function (n) { return n.endsWith('.dmg') && n.indexOf('arm64') !== -1; } },
-    { id: 'macos-intel', label: 'macOS, Intel', icon: 'i-apple', note: 'For older Intel based Macs.',
-      match: function (n) { return n.endsWith('.dmg') && n.indexOf('arm64') === -1; } },
     { id: 'linux-deb', label: 'Linux, Debian or Ubuntu', icon: 'i-linux', note: 'Pulls system deps automatically.',
       match: function (n) { return n.endsWith('.deb'); } },
     { id: 'linux-appimage', label: 'Linux, universal', icon: 'i-linux', note: 'No install. Mark executable and run.',
@@ -170,6 +163,19 @@
     });
 
     // Grid
+    var macCard =
+      '<div class="platform">' +
+        '<div class="platform-head">' + icon('i-apple') + '<h4>macOS</h4></div>' +
+        '<p class="pnote">No pre-built download &mdash; the unsigned app is blocked by Gatekeeper. Build from source instead.</p>' +
+        '<div class="dl-links">' +
+          '<a class="asset" href="https://github.com/' + REPO + '#quick-start" target="_blank" rel="noopener">' +
+            icon('i-download') +
+            '<span class="meta"><span class="fname">git clone &amp; ./setup.sh</span>' +
+            '<span class="fsize">Runs from source</span></span>' +
+            '<span class="go"><svg class="ic"><use href="#i-arrow"/></svg></span>' +
+          '</a>' +
+        '</div>' +
+      '</div>';
     el('dl-grid').innerHTML = byPlatform.map(function (g) {
       var links = g.assets.length
         ? g.assets.map(assetRow).join('')
@@ -179,30 +185,47 @@
         '<p class="pnote">' + g.p.note + '</p>' +
         '<div class="dl-links">' + links + '</div>' +
         '</div>';
-    }).join('');
+    }).join('') + macCard;
 
     // Recommended card for the visitor's OS
     var os = detectOS();
-    var rec = null;
-    for (var k = 0; k < byPlatform.length; k++) {
-      if (byPlatform[k].p.id === os && byPlatform[k].assets.length) { rec = byPlatform[k]; break; }
-    }
-    if (rec) {
-      var a = rec.assets[0];
+    if (os === 'macos') {
       el('dl-recommend').innerHTML =
         '<div class="rec-left">' +
-          '<span class="rec-ic">' + icon(rec.p.icon) + '</span>' +
+          '<span class="rec-ic">' + icon('i-apple') + '</span>' +
           '<span class="rec-text">' +
-            '<span class="rec-label">Recommended for you</span>' +
-            '<span class="rec-title">' + rec.p.label + '</span>' +
-            '<span class="rec-file">' + a.name + ' &middot; ' + fmtBytes(a.size) + '</span>' +
+            '<span class="rec-label">You are on macOS</span>' +
+            '<span class="rec-title">Build from source</span>' +
+            '<span class="rec-file">No signed build yet &middot; one-line ./setup.sh</span>' +
           '</span>' +
         '</div>' +
-        '<a class="btn btn-solid" href="' + a.browser_download_url + '" target="_blank" rel="noopener" download>' +
-          icon('i-download') + 'Download</a>';
+        '<a class="btn btn-solid" href="https://github.com/' + REPO + '#quick-start" target="_blank" rel="noopener">' +
+          icon('i-download') + 'How to run</a>';
       el('dl-recommend').classList.remove('hidden');
-      var heroLbl = el('hero-dl-label');
-      if (heroLbl) { heroLbl.textContent = 'Download for ' + (os.indexOf('mac') === 0 ? 'macOS' : os.indexOf('win') === 0 ? 'Windows' : 'Linux'); }
+      var heroLblMac = el('hero-dl-label');
+      if (heroLblMac) { heroLblMac.textContent = 'Build from source for macOS'; }
+    } else {
+      var rec = null;
+      for (var k = 0; k < byPlatform.length; k++) {
+        if (byPlatform[k].p.id === os && byPlatform[k].assets.length) { rec = byPlatform[k]; break; }
+      }
+      if (rec) {
+        var a = rec.assets[0];
+        el('dl-recommend').innerHTML =
+          '<div class="rec-left">' +
+            '<span class="rec-ic">' + icon(rec.p.icon) + '</span>' +
+            '<span class="rec-text">' +
+              '<span class="rec-label">Recommended for you</span>' +
+              '<span class="rec-title">' + rec.p.label + '</span>' +
+              '<span class="rec-file">' + a.name + ' &middot; ' + fmtBytes(a.size) + '</span>' +
+            '</span>' +
+          '</div>' +
+          '<a class="btn btn-solid" href="' + a.browser_download_url + '" target="_blank" rel="noopener" download>' +
+            icon('i-download') + 'Download</a>';
+        el('dl-recommend').classList.remove('hidden');
+        var heroLbl = el('hero-dl-label');
+        if (heroLbl) { heroLbl.textContent = 'Download for ' + (os.indexOf('win') === 0 ? 'Windows' : 'Linux'); }
+      }
     }
 
     el('dl-loading').classList.add('hidden');