From 1faf8c7f4f7970ef7657ac1225f11a10a2fce02c Mon Sep 17 00:00:00 2001 From: Ry J Date: Mon, 20 Jul 2026 17:00:14 +1000 Subject: [PATCH 1/3] docs: accurate unsigned-app install instructions + Homebrew option Co-Authored-By: Claude Fable 5 --- README.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ed34a9e..5ab2254 100644 --- a/README.md +++ b/README.md @@ -11,13 +11,28 @@ A desktop app for managing many [Claude Code](https://claude.com/claude-code) se ## Running it -### Option A — download a release (macOS arm64) +### Option A — Homebrew (macOS arm64) + +```sh +brew tap ryj-dev/tap +brew install --cask --no-quarantine session-manager +``` + +The `--no-quarantine` flag matters: the app is unsigned, and without it macOS will refuse to launch it (see Option B). + +### Option B — download a release (macOS arm64) 1. Grab the latest DMG from the [releases page](https://github.com/ryj-dev/session-manager/releases). 2. Open the DMG, drag *Session Manager* to Applications. -3. First launch will be blocked by Gatekeeper (the build is unsigned). Right-click the app → **Open** → confirm. Or, after the block dialog, go to **System Settings → Privacy & Security → Open Anyway**. +3. **The build is unsigned**, so on first launch macOS will report the app "is damaged and can't be opened" — it isn't damaged, it's quarantined. Clear the quarantine flag and it launches normally: + + ```sh + xattr -cr "/Applications/Session Manager.app" + ``` + + (Alternatively, download with `curl -L` instead of the browser — quarantine is only applied to browser downloads.) -### Option B — run from source +### Option C — run from source ```sh git clone https://github.com/ryj-dev/session-manager.git From 13448402b97b874f30abd5a04164c60a3741b280 Mon Sep 17 00:00:00 2001 From: Ry J Date: Mon, 20 Jul 2026 17:16:07 +1000 Subject: [PATCH 2/3] docs: Homebrew 6 install instructions (trust + postflight quarantine strip) Co-Authored-By: Claude Fable 5 --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5ab2254..d35222a 100644 --- a/README.md +++ b/README.md @@ -15,10 +15,11 @@ A desktop app for managing many [Claude Code](https://claude.com/claude-code) se ```sh brew tap ryj-dev/tap -brew install --cask --no-quarantine session-manager +brew trust ryj-dev/tap # Homebrew ≥ 6 requires trusting third-party taps +brew install --cask session-manager ``` -The `--no-quarantine` flag matters: the app is unsigned, and without it macOS will refuse to launch it (see Option B). +The app is unsigned, so macOS would normally block it as "damaged" on first launch — the cask removes the quarantine flag automatically after install, so it launches normally. ### Option B — download a release (macOS arm64) From b0e6b2a08ea8f32967fb4a17d4972aa6c2b21f41 Mon Sep 17 00:00:00 2001 From: Ry J Date: Tue, 21 Jul 2026 08:45:05 +1000 Subject: [PATCH 3/3] =?UTF-8?q?release:=20v0.2.1=20=E2=80=94=20fix=20MCP?= =?UTF-8?q?=20server=20in=20packaged=20app=20(disable=20asar)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The MCP registration pointed node at out/main/mcp-server.js inside app.asar, which plain node cannot read — so sessions started under the packaged app got no session-manager tools at all (broken in every packaged release since v0.1.0, masked by always running from dev). Disable asar so the bundle ships as real files; asarUnpack is dead config without asar and is removed. Co-Authored-By: Claude Fable 5 --- package.json | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/package.json b/package.json index d2b33dc..2f83789 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "session-manager", - "version": "0.2.0", + "version": "0.2.1", "description": "Desktop app for managing multiple Claude Code sessions", "author": "Ry J", "license": "MIT", @@ -31,6 +31,7 @@ "output": "release", "buildResources": "build" }, + "asar": false, "files": [ "out/**/*", "package.json", @@ -52,14 +53,6 @@ ] } ], - "asarUnpack": [ - "node_modules/better-sqlite3/**/*", - "node_modules/node-pty/**/*", - "node_modules/sqlite-vec/**/*", - "node_modules/sqlite-vec-darwin-arm64/**/*", - "node_modules/sqlite-vec-darwin-x64/**/*", - "node_modules/@huggingface/**/*" - ], "mac": { "category": "public.app-category.developer-tools", "target": [