fix(desktop): resolve agent CLIs from macOS login shell PATH

Probe login-shell PATH and common npm/pnpm/fnm install roots on macOS so Finder-launched desktop apps detect agents reliably. Bump desktop shell to v0.2.0.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: joohw

core/internal/buildinfo/buildinfo.go

@@ -4,7 +4,7 @@ import "strings"
 
 // Set at link time via -ldflags (see .goreleaser.yaml).
 var (
-	Version = "dev0.1.55"
+	Version = "dev0.1.57"
 	Commit  = "none"
 	Date    = "unknown"
 )

core/internal/desktop/agents.go

@@ -120,6 +120,12 @@ func commandSearchDirs() []string {
 		add(filepath.Join(home, ".config", "clovapi", "bin"))
 		add(filepath.Join(home, ".local", "bin"))
 		add(filepath.Join(home, ".opencode", "bin"))
+		for _, dir := range platformSearchDirs(home) {
+			add(dir)
+		}
+		for _, dir := range loginShellSearchDirs() {
+			add(dir)
+		}
 	}
 	if runtime.GOOS != "windows" {
 		add("/opt/homebrew/bin")
@@ -137,8 +143,5 @@ func executableFile(path string) bool {
 	if err != nil || info.IsDir() {
 		return false
 	}
-	if runtime.GOOS == "windows" {
-		return true
-	}
-	return info.Mode()&0o111 != 0
+	return isExecutableFile(path)
 }

core/internal/desktop/agents_darwin_dirs.go

@@ -0,0 +1,20 @@
+package desktop
+
+import "path/filepath"
+
+// darwinExtraSearchDirs lists common user-level install roots on macOS that are
+// often missing from the minimal PATH Finder/Dock gives GUI apps.
+func darwinExtraSearchDirs(home string) []string {
+	home = filepath.Clean(home)
+	if home == "" || home == "." {
+		return nil
+	}
+	return []string{
+		filepath.Join(home, "bin"),
+		filepath.Join(home, ".npm-global", "bin"),
+		filepath.Join(home, "Library", "pnpm"),
+		filepath.Join(home, ".volta", "bin"),
+		filepath.Join(home, ".local", "share", "fnm", "current", "bin"),
+		filepath.Join(home, ".fnm", "current", "bin"),
+	}
+}

core/internal/desktop/agents_executable_unix.go

@@ -0,0 +1,9 @@
+//go:build !windows
+
+package desktop
+
+import "syscall"
+
+func isExecutableFile(path string) bool {
+	return syscall.Access(path, syscall.X_OK) == nil
+}

core/internal/desktop/agents_executable_windows.go

@@ -0,0 +1,7 @@
+//go:build windows
+
+package desktop
+
+func isExecutableFile(path string) bool {
+	return true
+}

core/internal/desktop/agents_login_shell_darwin.go

@@ -0,0 +1,61 @@
+//go:build darwin
+
+package desktop
+
+import (
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+	"sync"
+)
+
+var (
+	darwinLoginShellDirsOnce sync.Once
+	darwinLoginShellDirs     []string
+)
+
+func loginShellSearchDirs() []string {
+	darwinLoginShellDirsOnce.Do(func() {
+		home, err := os.UserHomeDir()
+		if err != nil || strings.TrimSpace(home) == "" {
+			return
+		}
+		user := strings.TrimSpace(os.Getenv("USER"))
+		if user == "" {
+			user = strings.TrimSpace(os.Getenv("LOGNAME"))
+		}
+		shell := strings.TrimSpace(os.Getenv("SHELL"))
+		if shell == "" {
+			shell = "/bin/zsh"
+		}
+		cmd := exec.Command(shell, "-ilc", `printf %s "$PATH"`)
+		cmd.Env = []string{
+			"HOME=" + home,
+			"USER=" + user,
+			"LOGNAME=" + user,
+			"SHELL=" + shell,
+		}
+		out, err := cmd.Output()
+		if err != nil {
+			return
+		}
+		seen := map[string]struct{}{}
+		for _, dir := range filepath.SplitList(strings.TrimSpace(string(out))) {
+			dir = strings.TrimSpace(dir)
+			if dir == "" {
+				continue
+			}
+			if _, ok := seen[dir]; ok {
+				continue
+			}
+			seen[dir] = struct{}{}
+			darwinLoginShellDirs = append(darwinLoginShellDirs, dir)
+		}
+	})
+	return darwinLoginShellDirs
+}
+
+func platformSearchDirs(home string) []string {
+	return darwinExtraSearchDirs(home)
+}

core/internal/desktop/agents_login_shell_other.go

@@ -0,0 +1,11 @@
+//go:build !darwin
+
+package desktop
+
+func loginShellSearchDirs() []string {
+	return nil
+}
+
+func platformSearchDirs(home string) []string {
+	return nil
+}

core/internal/desktop/agents_test.go

@@ -7,6 +7,27 @@ import (
 	"testing"
 )
 
+func TestDarwinExtraSearchDirsIncludesCommonInstallRoots(t *testing.T) {
+	home := filepath.Join(string(filepath.Separator), "Users", "test")
+	dirs := darwinExtraSearchDirs(home)
+	want := []string{
+		filepath.Join(home, "bin"),
+		filepath.Join(home, ".npm-global", "bin"),
+		filepath.Join(home, "Library", "pnpm"),
+		filepath.Join(home, ".volta", "bin"),
+		filepath.Join(home, ".local", "share", "fnm", "current", "bin"),
+		filepath.Join(home, ".fnm", "current", "bin"),
+	}
+	if len(dirs) != len(want) {
+		t.Fatalf("dirs = %#v, want %d entries", dirs, len(want))
+	}
+	for i, path := range want {
+		if dirs[i] != path {
+			t.Fatalf("dirs[%d] = %q, want %q", i, dirs[i], path)
+		}
+	}
+}
+
 func TestResolveCommandPathUsesCommonUserBinDirs(t *testing.T) {
 	if runtime.GOOS == "windows" {
 		t.Skip("HOME-based user bin probing is only used on Unix-like platforms")

electron/cli-path-register.js

@@ -1,7 +1,7 @@
+const { spawnSync } = require("node:child_process");
 const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
-const { spawnSync } = require("node:child_process");
 const { cliBinPath } = require("./config-paths");
 
 const MARKER_START = "# >>> clovapi >>>";
@@ -174,11 +174,33 @@ function ensureCliBinOnPath() {
   return ensureUnixShellPath(dir);
 }
 
+function loginShellPathEntries(baseEnv = process.env) {
+  if (process.platform !== "darwin") return [];
+  const home = os.homedir();
+  const shell = String(baseEnv.SHELL || "/bin/zsh").trim() || "/bin/zsh";
+  const user = String(baseEnv.USER || baseEnv.LOGNAME || os.userInfo().username || "").trim();
+  const result = spawnSync(shell, ["-ilc", 'printf %s "$PATH"'], {
+    encoding: "utf8",
+    env: {
+      HOME: home,
+      USER: user,
+      LOGNAME: user,
+      SHELL: shell,
+    },
+  });
+  if (result.status !== 0) return [];
+  return String(result.stdout || "")
+    .split(":")
+    .map((entry) => entry.trim())
+    .filter(Boolean);
+}
+
 function cliSpawnEnv(baseEnv = process.env) {
   const binDir = cliBinDir();
   const parts = [binDir];
   const seen = new Set([binDir]);
-  for (const entry of String(baseEnv.PATH || "").split(path.delimiter)) {
+  const prepend = loginShellPathEntries(baseEnv);
+  for (const entry of [...prepend, ...String(baseEnv.PATH || "").split(path.delimiter)]) {
     const value = String(entry || "").trim();
     if (!value || seen.has(value)) continue;
     seen.add(value);
@@ -194,6 +216,7 @@ module.exports = {
   cliBinDir,
   cliSpawnEnv,
   ensureCliBinOnPath,
+  loginShellPathEntries,
   shellProfileCandidates,
   upsertMarkedBlock,
 };

electron/cli-path-register.test.js

@@ -6,7 +6,10 @@ const test = require("node:test");
 
 const {
   buildPathBlock,
+  cliBinDir,
+  cliSpawnEnv,
   ensureCliBinOnPath,
+  loginShellPathEntries,
   upsertMarkedBlock,
 } = require("./cli-path-register");
 const { cliBinPath } = require("./config-paths");
@@ -23,14 +26,37 @@ function withTempConfigHome(t) {
   return root;
 }
 
-test("buildPathBlock includes managed markers", () => {
+test("loginShellPathEntries returns empty on non-darwin", (t) => {
+  if (process.platform === "darwin") {
+    t.skip("non-darwin only");
+    return;
+  }
+  assert.deepEqual(loginShellPathEntries(), []);
+});
+
+test("cliSpawnEnv prepends clovapi bin before inherited PATH", () => {
+  const env = cliSpawnEnv({ PATH: "/usr/bin:/bin", USER: "tester" });
+  const parts = String(env.PATH || "").split(path.delimiter);
+  assert.equal(parts[0], cliBinDir());
+  assert.match(env.PATH || "", /usr[\\/]bin/);
+});
+
+test("buildPathBlock includes managed markers", (t) => {
+  if (process.platform === "win32") {
+    t.skip("unix shell profile block");
+    return;
+  }
   const block = buildPathBlock("/tmp/clovapi/bin");
   assert.match(block, /# >>> clovapi >>>/);
   assert.match(block, /export PATH="\/tmp\/clovapi\/bin:\$PATH"/);
   assert.match(block, /# <<< clovapi <<</);
 });
 
-test("upsertMarkedBlock replaces an existing block", () => {
+test("upsertMarkedBlock replaces an existing block", (t) => {
+  if (process.platform === "win32") {
+    t.skip("unix shell profile block");
+    return;
+  }
   const original = ["before", buildPathBlock("/old/bin"), "after"].join("\n");
   const next = upsertMarkedBlock(original, buildPathBlock("/new/bin"));
   assert.match(next, /\/new\/bin:\$PATH/);