editor-profile-sync 1.0.2 → 1.0.4

package/README.md

@@ -14,7 +14,16 @@ You can sync:
 
 - **Node.js** 18 or newer
 - **npm** (comes with Node.js)
-- At least one [supported editor](#supported-editors) installed, with its CLI on your PATH (e.g. `code`, `cursor`)
+- At least one [supported editor](#supported-editors) installed
+  - **macOS**: Choose one of the following options:
+    - **Option 1 (Recommended)**: Install terminal command:
+      1. Open your editor
+      2. Press `Cmd + Shift + P` to open the Command Palette
+      3. Type: `shell command`
+      4. Select: **Shell Command: Install '[command]' command in PATH**
+      5. Restart your terminal
+    - **Option 2**: Have the editor installed in `/Applications/` (e.g., `/Applications/Visual Studio Code.app`). The CLI will be auto-detected from the app bundle.
+  - **Windows/Linux**: Editor CLI must be on your PATH (e.g., `code`, `cursor`)
 
 ## Install
 
@@ -127,7 +136,9 @@ These editors are currently supported:
 | VS Code     | `code`        |
 | Windsurf    | `windsurf`    |
 
-Each editor must be installed and available in your terminal (e.g. `code`, `cursor`).
+**macOS**: Editors work with either option: install terminal command (recommended) or auto-detect from `/Applications/` if installed as `.app` bundles.
+
+**Windows/Linux**: Each editor must be installed and its CLI available in your terminal (e.g. `code`, `cursor`).
 
 ## Generated files
 

package/index.js

@@ -71,12 +71,27 @@ async function main() {
   );
 
   if (availableEditors.length === 0) {
-    detectSpinner.fail("No supported editors found on PATH.");
-    console.log(
-      chalk.yellow(
-        "\n  Install at least one supported editor and make sure its CLI is on your PATH.\n",
-      ),
-    );
+    detectSpinner.fail("No supported editors found.");
+    if (process.platform === "darwin") {
+      console.log(
+        chalk.yellow(
+          "\n  On macOS, you have two options:\n" +
+            "  1. Install terminal command (recommended):\n" +
+            "     • Open your editor\n" +
+            "     • Press Cmd + Shift + P\n" +
+            "     • Type: shell command\n" +
+            "     • Select: Shell Command: Install '[command]' command in PATH\n" +
+            "     • Restart your terminal\n" +
+            "  2. Or make sure the editor is installed in /Applications/[EditorName].app\n",
+        ),
+      );
+    } else {
+      console.log(
+        chalk.yellow(
+          "\n  Install at least one supported editor and make sure its CLI is on your PATH.\n",
+        ),
+      );
+    }
     process.exit(1);
   }
 

package/lib/editor-cli.js

@@ -1,15 +1,80 @@
 import { execSync, spawn } from "child_process";
+import { existsSync } from "fs";
+import { join } from "path";
+
+// macOS app bundle names for each editor
+const MACOS_APP_BUNDLES = {
+  antigravity: "Antigravity.app",
+  cursor: "Cursor.app",
+  kiro: "Kiro.app",
+  trae: "Trae.app",
+  code: "Visual Studio Code.app",
+  windsurf: "Windsurf.app",
+};
+
+function findMacOSCliPath(editor) {
+  if (process.platform !== "darwin") return null;
+
+  const appName = MACOS_APP_BUNDLES[editor.id];
+  if (!appName) return null;
+
+  const appPath = join("/Applications", appName);
+  if (!existsSync(appPath)) return null;
+
+  // VS Code-based editors typically have CLI at:
+  // /Applications/AppName.app/Contents/Resources/app/bin/command
+  const cliPath = join(
+    appPath,
+    "Contents",
+    "Resources",
+    "app",
+    "bin",
+    editor.cmd,
+  );
+
+  if (existsSync(cliPath)) {
+    return cliPath;
+  }
+
+  return null;
+}
 
 export function isEditorInstalled(editor) {
+  // First check PATH
   const cmd = process.platform === "win32" ? "where" : "which";
   try {
     execSync(`${cmd} ${editor.cmd}`, { stdio: "ignore" });
     return true;
   } catch {
+    // On macOS, also check app bundles
+    if (process.platform === "darwin") {
+      return findMacOSCliPath(editor) !== null;
+    }
     return false;
   }
 }
 
+export function getEditorCliPath(editor) {
+  // First check PATH
+  const cmd = process.platform === "win32" ? "where" : "which";
+  try {
+    const result = execSync(`${cmd} ${editor.cmd}`, { encoding: "utf-8" });
+    const path = result.trim().split("\n")[0];
+    if (path) return path;
+  } catch {
+    // Fall through to fallback options
+  }
+
+  // On macOS, fall back to app bundle path
+  if (process.platform === "darwin") {
+    const macPath = findMacOSCliPath(editor);
+    if (macPath) return macPath;
+  }
+
+  // Final fallback: use command name (should work if in PATH)
+  return editor.cmd;
+}
+
 function escapeShellArg(arg) {
   const s = String(arg);
   return s.includes(" ") || s.includes('"') ? `"${s.replace(/"/g, '""')}"` : s;
@@ -17,7 +82,10 @@ function escapeShellArg(arg) {
 
 function runEditorCmdAsync(editor, args, options = {}) {
   const { ignoreError = false } = options;
-  const cmdString = [editor.cmd, ...args.map(escapeShellArg)].join(" ");
+  const cliPath = getEditorCliPath(editor);
+  const cmdString = [escapeShellArg(cliPath), ...args.map(escapeShellArg)].join(
+    " ",
+  );
 
   return new Promise((resolve, reject) => {
     const child = spawn(cmdString, [], {
@@ -73,6 +141,11 @@ export async function installExtension(editor, extensionId) {
 }
 
 export function uninstallExtension(editor, extensionId) {
-  const cmd = [editor.cmd, "--uninstall-extension", extensionId].join(" ");
+  const cliPath = getEditorCliPath(editor);
+  const cmd = [
+    escapeShellArg(cliPath),
+    "--uninstall-extension",
+    escapeShellArg(extensionId),
+  ].join(" ");
   execSync(cmd, { stdio: "ignore" });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "editor-profile-sync",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Cross-platform extensions, settings.json, and snippets sync for VS Code-based editors",
   "type": "module",
   "main": "index.js",