cursor-kit-cli 1.5.0 → 1.6.0-beta.1

package/dist/cli.cjs

@@ -1562,8 +1562,8 @@ async function convertPulledFilesForTarget(target, directories) {
       const skillPath = (0, import_node_path6.join)(skillsDir, skillDir);
       const skillMdPath = (0, import_node_path6.join)(skillPath, "SKILL.md");
       const skillMdcPath = (0, import_node_path6.join)(skillPath, "SKILL.mdc");
-      const { existsSync: existsSync3 } = await import("fs");
-      if (existsSync3(skillMdPath)) {
+      const { existsSync: existsSync4 } = await import("fs");
+      if (existsSync4(skillMdPath)) {
         const content = readFile(skillMdPath);
         writeFile(skillMdcPath, content);
         const { rmSync: rmSync2 } = await import("fs");
@@ -2060,17 +2060,305 @@ var import_citty6 = require("citty");
 var p8 = __toESM(require("@clack/prompts"), 1);
 var import_picocolors8 = __toESM(require("picocolors"), 1);
 var import_node_child_process = require("child_process");
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 var import_node_url2 = require("url");
+var import_node_fs3 = require("fs");
+
+// src/utils/alias.ts
 var import_node_fs2 = require("fs");
+var import_node_os = require("os");
+var import_node_path9 = require("path");
+var CURSOR_KIT_DIR = ".cursor-kit";
+var ALIASES_FILE = "aliases.json";
+function getAliasConfigDir() {
+  return (0, import_node_path9.join)((0, import_node_os.homedir)(), CURSOR_KIT_DIR);
+}
+function getAliasConfigPath() {
+  return (0, import_node_path9.join)(getAliasConfigDir(), ALIASES_FILE);
+}
+function ensureConfigDir() {
+  const configDir = getAliasConfigDir();
+  if (!(0, import_node_fs2.existsSync)(configDir)) {
+    (0, import_node_fs2.mkdirSync)(configDir, { recursive: true });
+  }
+}
+function loadAliasConfig() {
+  const configPath = getAliasConfigPath();
+  if (!(0, import_node_fs2.existsSync)(configPath)) {
+    return { aliases: {} };
+  }
+  try {
+    const content = (0, import_node_fs2.readFileSync)(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return { aliases: {} };
+  }
+}
+function saveAliasConfig(config) {
+  ensureConfigDir();
+  const configPath = getAliasConfigPath();
+  (0, import_node_fs2.writeFileSync)(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function getInstanceDataDir(instanceName) {
+  return (0, import_node_path9.join)(
+    (0, import_node_os.homedir)(),
+    "Library",
+    "Application Support",
+    instanceName.replace(/ /g, "")
+  );
+}
+function getInstanceAppPath(instanceName) {
+  return (0, import_node_path9.join)((0, import_node_os.homedir)(), "Applications", `${instanceName}.app`);
+}
+function generateScriptContent(instanceName) {
+  const dataDir = getInstanceDataDir(instanceName);
+  const appPath = getInstanceAppPath(instanceName);
+  return `#!/usr/bin/env bash
+# Generated by cursor-kit for instance: ${instanceName}
+# This script opens the specified directory (or current directory) in the Cursor instance
+
+set -euo pipefail
+
+DIR="\${1:-.}"
+
+# Resolve to absolute path if relative
+if [[ "$DIR" != /* ]]; then
+  DIR="$(cd "$DIR" 2>/dev/null && pwd)"
+fi
+
+DATA_DIR="${dataDir}"
+APP_PATH="${appPath}"
+
+if [ ! -d "$APP_PATH" ]; then
+  echo "Error: Cursor instance not found at $APP_PATH" >&2
+  echo "The instance may have been removed. Run 'cursor-kit instance -l' to see available instances." >&2
+  exit 1
+fi
+
+open -n "$APP_PATH" --args --user-data-dir "$DATA_DIR" "$DIR"
+`;
+}
+function generateShellFunction(aliasName, instanceName) {
+  const dataDir = getInstanceDataDir(instanceName);
+  const appPath = getInstanceAppPath(instanceName);
+  return `
+# cursor-kit alias: ${aliasName} -> ${instanceName}
+${aliasName}() {
+  local DIR="\${1:-.}"
+  if [[ "$DIR" != /* ]]; then
+    DIR="$(cd "$DIR" 2>/dev/null && pwd)"
+  fi
+  local DATA_DIR="${dataDir}"
+  local APP_PATH="${appPath}"
+  if [ ! -d "$APP_PATH" ]; then
+    echo "Error: Cursor instance not found at $APP_PATH" >&2
+    return 1
+  fi
+  open -n "$APP_PATH" --args --user-data-dir "$DATA_DIR" "$DIR"
+}
+# end cursor-kit alias: ${aliasName}
+`;
+}
+function detectShellConfigPath() {
+  const home = (0, import_node_os.homedir)();
+  const shell = process.env.SHELL ?? "/bin/zsh";
+  if (shell.includes("zsh")) {
+    return (0, import_node_path9.join)(home, ".zshrc");
+  }
+  if (shell.includes("bash")) {
+    const bashProfile = (0, import_node_path9.join)(home, ".bash_profile");
+    if ((0, import_node_fs2.existsSync)(bashProfile)) {
+      return bashProfile;
+    }
+    return (0, import_node_path9.join)(home, ".bashrc");
+  }
+  return (0, import_node_path9.join)(home, ".zshrc");
+}
+function getHomeBinDir() {
+  return (0, import_node_path9.join)((0, import_node_os.homedir)(), "bin");
+}
+function getUsrLocalBinDir() {
+  return "/usr/local/bin";
+}
+function ensureBinDir(binDir) {
+  if (!(0, import_node_fs2.existsSync)(binDir)) {
+    (0, import_node_fs2.mkdirSync)(binDir, { recursive: true });
+  }
+}
+function createExecutableScript(aliasName, instanceName, targetDir) {
+  ensureBinDir(targetDir);
+  const scriptPath = (0, import_node_path9.join)(targetDir, aliasName);
+  const scriptContent = generateScriptContent(instanceName);
+  (0, import_node_fs2.writeFileSync)(scriptPath, scriptContent, "utf-8");
+  (0, import_node_fs2.chmodSync)(scriptPath, 493);
+  return scriptPath;
+}
+function createShellAlias(aliasName, instanceName, shellConfigPath) {
+  const functionContent = generateShellFunction(aliasName, instanceName);
+  if (!(0, import_node_fs2.existsSync)(shellConfigPath)) {
+    (0, import_node_fs2.writeFileSync)(shellConfigPath, "", "utf-8");
+  }
+  const existingContent = (0, import_node_fs2.readFileSync)(shellConfigPath, "utf-8");
+  if (existingContent.includes(`# cursor-kit alias: ${aliasName}`)) {
+    removeShellAlias(aliasName, shellConfigPath);
+  }
+  (0, import_node_fs2.appendFileSync)(shellConfigPath, functionContent, "utf-8");
+}
+function removeShellAlias(aliasName, shellConfigPath) {
+  if (!(0, import_node_fs2.existsSync)(shellConfigPath)) {
+    return false;
+  }
+  const content = (0, import_node_fs2.readFileSync)(shellConfigPath, "utf-8");
+  const startMarker = `# cursor-kit alias: ${aliasName}`;
+  const endMarker = `# end cursor-kit alias: ${aliasName}`;
+  const startIndex = content.indexOf(startMarker);
+  if (startIndex === -1) {
+    return false;
+  }
+  const endIndex = content.indexOf(endMarker);
+  if (endIndex === -1) {
+    return false;
+  }
+  const before = content.slice(0, startIndex);
+  const after = content.slice(endIndex + endMarker.length);
+  const newContent = (before + after).replace(/\n{3,}/g, "\n\n");
+  (0, import_node_fs2.writeFileSync)(shellConfigPath, newContent, "utf-8");
+  return true;
+}
+function removeExecutableScript(scriptPath) {
+  if (!(0, import_node_fs2.existsSync)(scriptPath)) {
+    return false;
+  }
+  try {
+    (0, import_node_fs2.unlinkSync)(scriptPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function createAlias(options) {
+  const { aliasName, instanceName, storageLocation } = options;
+  try {
+    let scriptPath;
+    let shellConfigPath;
+    switch (storageLocation) {
+      case "shell-config": {
+        shellConfigPath = detectShellConfigPath();
+        createShellAlias(aliasName, instanceName, shellConfigPath);
+        break;
+      }
+      case "usr-local-bin": {
+        scriptPath = createExecutableScript(
+          aliasName,
+          instanceName,
+          getUsrLocalBinDir()
+        );
+        break;
+      }
+      case "home-bin": {
+        scriptPath = createExecutableScript(
+          aliasName,
+          instanceName,
+          getHomeBinDir()
+        );
+        break;
+      }
+    }
+    const config = loadAliasConfig();
+    config.aliases[aliasName] = {
+      instanceName,
+      aliasName,
+      storageLocation,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      scriptPath
+    };
+    saveAliasConfig(config);
+    return { success: true, scriptPath, shellConfigPath };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "Unknown error"
+    };
+  }
+}
+function removeAlias(aliasName) {
+  const config = loadAliasConfig();
+  const entry = config.aliases[aliasName];
+  if (!entry) {
+    return false;
+  }
+  let removed = false;
+  switch (entry.storageLocation) {
+    case "shell-config": {
+      const shellConfigPath = detectShellConfigPath();
+      removed = removeShellAlias(aliasName, shellConfigPath);
+      break;
+    }
+    case "usr-local-bin": {
+      const scriptPath = (0, import_node_path9.join)(getUsrLocalBinDir(), aliasName);
+      removed = removeExecutableScript(scriptPath);
+      break;
+    }
+    case "home-bin": {
+      const scriptPath = (0, import_node_path9.join)(getHomeBinDir(), aliasName);
+      removed = removeExecutableScript(scriptPath);
+      break;
+    }
+  }
+  delete config.aliases[aliasName];
+  saveAliasConfig(config);
+  return removed;
+}
+function getAliasForInstance(instanceName) {
+  const config = loadAliasConfig();
+  for (const entry of Object.values(config.aliases)) {
+    if (entry.instanceName === instanceName) {
+      return entry;
+    }
+  }
+  return null;
+}
+function aliasExists(aliasName) {
+  const config = loadAliasConfig();
+  return aliasName in config.aliases;
+}
+function generateAliasName(instanceName) {
+  return instanceName.toLowerCase().replace(/^cursor\s*/i, "cursor-").replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function getStorageLocationLabel(location) {
+  switch (location) {
+    case "shell-config":
+      return "Shell config (~/.zshrc or ~/.bashrc)";
+    case "usr-local-bin":
+      return "/usr/local/bin (system-wide)";
+    case "home-bin":
+      return "~/bin (user-local)";
+  }
+}
+function isHomeBinInPath() {
+  const pathEnv = process.env.PATH ?? "";
+  const homeBin = getHomeBinDir();
+  return pathEnv.split(":").some((p9) => p9 === homeBin || p9 === "~/bin" || p9 === "$HOME/bin");
+}
+function getPathSetupInstructions() {
+  const shell = process.env.SHELL ?? "/bin/zsh";
+  const configFile = shell.includes("zsh") ? "~/.zshrc" : "~/.bashrc";
+  return `Add the following to your ${configFile}:
+
+export PATH="$HOME/bin:$PATH"
+
+Then restart your terminal or run: source ${configFile}`;
+}
+
+// src/commands/instance.ts
 function getBinPath() {
-  const currentDir = (0, import_node_path9.dirname)((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const currentDir = (0, import_node_path10.dirname)((0, import_node_url2.fileURLToPath)(importMetaUrl));
   const possiblePaths = [
-    (0, import_node_path9.join)(currentDir, "..", "..", "bin"),
-    (0, import_node_path9.join)(currentDir, "..", "bin")
+    (0, import_node_path10.join)(currentDir, "..", "..", "bin"),
+    (0, import_node_path10.join)(currentDir, "..", "bin")
   ];
   for (const binPath of possiblePaths) {
-    if ((0, import_node_fs2.existsSync)(binPath)) {
+    if ((0, import_node_fs3.existsSync)(binPath)) {
       return binPath;
     }
   }
@@ -2078,19 +2366,24 @@ function getBinPath() {
 }
 function ensureExecutable(scriptPath) {
   try {
-    (0, import_node_fs2.chmodSync)(scriptPath, 493);
+    (0, import_node_fs3.chmodSync)(scriptPath, 493);
   } catch {
   }
 }
 function getExistingInstances() {
-  const userAppsDir = (0, import_node_path9.join)(process.env.HOME ?? "", "Applications");
-  if (!(0, import_node_fs2.existsSync)(userAppsDir)) return [];
+  const userAppsDir = (0, import_node_path10.join)(process.env.HOME ?? "", "Applications");
+  if (!(0, import_node_fs3.existsSync)(userAppsDir)) return [];
   try {
-    const apps = (0, import_node_fs2.readdirSync)(userAppsDir);
-    return apps.filter((app) => app.startsWith("Cursor") && app.endsWith(".app") && app !== "Cursor.app").map((app) => ({
-      name: app.replace(".app", ""),
-      path: (0, import_node_path9.join)(userAppsDir, app)
-    }));
+    const apps = (0, import_node_fs3.readdirSync)(userAppsDir);
+    return apps.filter((app) => app.startsWith("Cursor") && app.endsWith(".app") && app !== "Cursor.app").map((app) => {
+      const name = app.replace(".app", "");
+      const aliasEntry = getAliasForInstance(name);
+      return {
+        name,
+        path: (0, import_node_path10.join)(userAppsDir, app),
+        alias: aliasEntry?.aliasName
+      };
+    });
   } catch {
     return [];
   }
@@ -2109,6 +2402,180 @@ function runScript(scriptPath, args) {
     });
   });
 }
+async function promptAliasCreation(instanceName, providedAlias, providedLocation, skipConfirmation) {
+  if (!skipConfirmation) {
+    const shouldCreateAlias = await p8.confirm({
+      message: "Would you like to create a shell alias for this instance?",
+      initialValue: true
+    });
+    if (p8.isCancel(shouldCreateAlias) || !shouldCreateAlias) {
+      return null;
+    }
+  }
+  let aliasName;
+  const suggestedAlias = generateAliasName(instanceName);
+  if (providedAlias) {
+    aliasName = providedAlias;
+  } else {
+    const aliasResult = await p8.text({
+      message: "Enter alias name:",
+      placeholder: suggestedAlias,
+      initialValue: suggestedAlias,
+      validate: (value) => {
+        if (!value.trim()) return "Alias name is required";
+        if (!/^[a-z0-9-]+$/.test(value)) return "Alias must contain only lowercase letters, numbers, and hyphens";
+        if (aliasExists(value)) return `Alias "${value}" already exists`;
+        return void 0;
+      }
+    });
+    if (p8.isCancel(aliasResult)) {
+      return null;
+    }
+    aliasName = aliasResult;
+  }
+  let location;
+  if (providedLocation && ["shell-config", "usr-local-bin", "home-bin"].includes(providedLocation)) {
+    location = providedLocation;
+  } else {
+    const locationResult = await p8.select({
+      message: "Where should the alias be stored?",
+      options: [
+        {
+          value: "shell-config",
+          label: "Shell config",
+          hint: detectShellConfigPath()
+        },
+        {
+          value: "home-bin",
+          label: "~/bin",
+          hint: "User-local executable scripts"
+        },
+        {
+          value: "usr-local-bin",
+          label: "/usr/local/bin",
+          hint: "System-wide (may require sudo)"
+        }
+      ]
+    });
+    if (p8.isCancel(locationResult)) {
+      return null;
+    }
+    location = locationResult;
+  }
+  return { aliasName, location };
+}
+async function handleAliasCreation(instanceName, aliasName, location) {
+  const result = createAlias({
+    aliasName,
+    instanceName,
+    storageLocation: location
+  });
+  if (!result.success) {
+    printWarning(`Failed to create alias: ${result.error}`);
+    return false;
+  }
+  console.log();
+  printSuccess(`Alias ${highlight(aliasName)} created!`);
+  console.log(import_picocolors8.default.dim(`  \u2514\u2500 Location: ${getStorageLocationLabel(location)}`));
+  if (location === "home-bin" && !isHomeBinInPath()) {
+    console.log();
+    printWarning("~/bin is not in your PATH");
+    console.log(import_picocolors8.default.dim(getPathSetupInstructions()));
+  }
+  if (location === "shell-config") {
+    console.log();
+    console.log(import_picocolors8.default.dim("  Restart your terminal or run:"));
+    console.log(import_picocolors8.default.dim(`  source ${detectShellConfigPath()}`));
+  }
+  console.log();
+  console.log(import_picocolors8.default.dim("  Usage:"));
+  console.log(import_picocolors8.default.dim(`  ${aliasName} .              # Open current directory`));
+  console.log(import_picocolors8.default.dim(`  ${aliasName} /path/to/dir   # Open specific directory`));
+  return true;
+}
+async function handleAliasRemoval(instanceName) {
+  const aliasEntry = getAliasForInstance(instanceName);
+  if (!aliasEntry) {
+    return;
+  }
+  const shouldRemove = await p8.confirm({
+    message: `Remove associated alias "${aliasEntry.aliasName}"?`,
+    initialValue: true
+  });
+  if (p8.isCancel(shouldRemove) || !shouldRemove) {
+    return;
+  }
+  const removed = removeAlias(aliasEntry.aliasName);
+  if (removed) {
+    printSuccess(`Alias ${highlight(aliasEntry.aliasName)} removed`);
+  } else {
+    printWarning(`Could not remove alias ${aliasEntry.aliasName}`);
+  }
+}
+async function handleAliasAction(instanceName, providedAlias, providedLocation) {
+  const existingAlias = getAliasForInstance(instanceName);
+  if (existingAlias) {
+    console.log();
+    printInfo(`Instance ${highlight(instanceName)} already has alias: ${highlight(existingAlias.aliasName)}`);
+    console.log(import_picocolors8.default.dim(`  \u2514\u2500 Location: ${getStorageLocationLabel(existingAlias.storageLocation)}`));
+    console.log();
+    const updateChoice = await p8.select({
+      message: "What would you like to do?",
+      options: [
+        {
+          value: "update",
+          label: "Update alias",
+          hint: "Change alias name or location"
+        },
+        {
+          value: "remove",
+          label: "Remove alias",
+          hint: "Delete the existing alias"
+        },
+        {
+          value: "keep",
+          label: "Keep current alias",
+          hint: "No changes"
+        }
+      ]
+    });
+    if (p8.isCancel(updateChoice) || updateChoice === "keep") {
+      p8.outro(import_picocolors8.default.dim("No changes made"));
+      return;
+    }
+    if (updateChoice === "remove") {
+      const removed = removeAlias(existingAlias.aliasName);
+      if (removed) {
+        console.log();
+        printSuccess(`Alias ${highlight(existingAlias.aliasName)} removed`);
+        console.log();
+        p8.outro(import_picocolors8.default.green("\u2728 Done!"));
+      } else {
+        printWarning(`Could not remove alias ${existingAlias.aliasName}`);
+        p8.outro(import_picocolors8.default.yellow("Check file permissions"));
+      }
+      return;
+    }
+    removeAlias(existingAlias.aliasName);
+  }
+  const aliasConfig = await promptAliasCreation(
+    instanceName,
+    providedAlias,
+    providedLocation,
+    true
+  );
+  if (!aliasConfig) {
+    p8.outro(import_picocolors8.default.dim("Alias creation cancelled"));
+    return;
+  }
+  const success = await handleAliasCreation(instanceName, aliasConfig.aliasName, aliasConfig.location);
+  if (success) {
+    console.log();
+    p8.outro(import_picocolors8.default.green("\u2728 Done!"));
+  } else {
+    p8.outro(import_picocolors8.default.yellow("Alias creation failed"));
+  }
+}
 var instanceCommand = (0, import_citty6.defineCommand)({
   meta: {
     name: "instance",
@@ -2118,7 +2585,7 @@ var instanceCommand = (0, import_citty6.defineCommand)({
     action: {
       type: "string",
       alias: "a",
-      description: "Action: 'create', 'reinstall', or 'remove'"
+      description: "Action: 'create', 'reinstall', 'remove', or 'alias'"
     },
     name: {
       type: "string",
@@ -2130,6 +2597,20 @@ var instanceCommand = (0, import_citty6.defineCommand)({
       alias: "l",
       description: "List existing Cursor instances",
       default: false
+    },
+    alias: {
+      type: "string",
+      alias: "A",
+      description: "Shell alias name for the instance (e.g. 'cursor-work')"
+    },
+    aliasLocation: {
+      type: "string",
+      description: "Alias storage location: 'shell-config', 'usr-local-bin', or 'home-bin'"
+    },
+    skipAlias: {
+      type: "boolean",
+      description: "Skip alias creation prompt",
+      default: false
     }
   },
   async run({ args }) {
@@ -2153,7 +2634,8 @@ var instanceCommand = (0, import_citty6.defineCommand)({
         console.log(import_picocolors8.default.bold(import_picocolors8.default.cyan("  \u{1F5A5}  Cursor Instances")) + import_picocolors8.default.dim(` (${instances.length})`));
         console.log();
         for (const instance of instances) {
-          console.log(`  ${import_picocolors8.default.green("\u25CF")} ${highlight(instance.name)}`);
+          const aliasInfo = instance.alias ? import_picocolors8.default.dim(` (alias: ${import_picocolors8.default.cyan(instance.alias)})`) : "";
+          console.log(`  ${import_picocolors8.default.green("\u25CF")} ${highlight(instance.name)}${aliasInfo}`);
           console.log(import_picocolors8.default.dim(`    \u2514\u2500 ${instance.path}`));
         }
       }
@@ -2162,13 +2644,55 @@ var instanceCommand = (0, import_citty6.defineCommand)({
       p8.outro(import_picocolors8.default.dim(`Total: ${instances.length} instance${instances.length !== 1 ? "s" : ""}`));
       return;
     }
+    const existingInstances = getExistingInstances();
+    if (args.action === "alias") {
+      if (existingInstances.length === 0) {
+        console.log();
+        printInfo("No custom Cursor instances found.");
+        console.log(import_picocolors8.default.dim("  Create an instance first with: ") + highlight("cursor-kit instance -a create"));
+        console.log();
+        p8.outro(import_picocolors8.default.dim("Nothing to do"));
+        return;
+      }
+      let instanceName2;
+      if (args.name) {
+        const found = existingInstances.find((i) => i.name === args.name);
+        if (!found) {
+          printWarning(`Instance "${args.name}" not found.`);
+          console.log(import_picocolors8.default.dim("  Available instances:"));
+          for (const inst of existingInstances) {
+            console.log(import_picocolors8.default.dim(`    \u2022 ${inst.name}`));
+          }
+          console.log();
+          p8.outro(import_picocolors8.default.dim("Nothing to do"));
+          return;
+        }
+        instanceName2 = args.name;
+      } else {
+        const instanceResult = await p8.select({
+          message: "Select instance to manage alias:",
+          options: existingInstances.map((inst) => ({
+            value: inst.name,
+            label: inst.alias ? `${inst.name} (alias: ${inst.alias})` : inst.name,
+            hint: inst.alias ? "Has alias" : "No alias"
+          }))
+        });
+        if (p8.isCancel(instanceResult)) {
+          p8.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        instanceName2 = instanceResult;
+      }
+      await handleAliasAction(instanceName2, args.alias, args.aliasLocation);
+      return;
+    }
     const s = p8.spinner();
     s.start("Checking prerequisites...");
     const binPath = getBinPath();
-    const createScript = (0, import_node_path9.join)(binPath, "cursor-new-instance");
-    const removeScript = (0, import_node_path9.join)(binPath, "cursor-remove-instance");
-    const reinstallScript = (0, import_node_path9.join)(binPath, "cursor-reinstall-instance.sh");
-    const scriptsExist = (0, import_node_fs2.existsSync)(createScript) && (0, import_node_fs2.existsSync)(removeScript) && (0, import_node_fs2.existsSync)(reinstallScript);
+    const createScript = (0, import_node_path10.join)(binPath, "cursor-new-instance");
+    const removeScript = (0, import_node_path10.join)(binPath, "cursor-remove-instance");
+    const reinstallScript = (0, import_node_path10.join)(binPath, "cursor-reinstall-instance.sh");
+    const scriptsExist = (0, import_node_fs3.existsSync)(createScript) && (0, import_node_fs3.existsSync)(removeScript) && (0, import_node_fs3.existsSync)(reinstallScript);
     if (!scriptsExist) {
       s.stop("Prerequisites check failed");
       console.log();
@@ -2179,7 +2703,7 @@ var instanceCommand = (0, import_citty6.defineCommand)({
       process.exit(1);
     }
     const originalCursor = "/Applications/Cursor.app";
-    if (!(0, import_node_fs2.existsSync)(originalCursor)) {
+    if (!(0, import_node_fs3.existsSync)(originalCursor)) {
       s.stop("Prerequisites check failed");
       console.log();
       printWarning("Cursor.app not found in /Applications");
@@ -2189,7 +2713,6 @@ var instanceCommand = (0, import_citty6.defineCommand)({
       process.exit(1);
     }
     s.stop("Prerequisites verified");
-    const existingInstances = getExistingInstances();
     let action;
     let instanceName;
     if (args.action && ["create", "remove", "reinstall"].includes(args.action)) {
@@ -2203,6 +2726,11 @@ var instanceCommand = (0, import_citty6.defineCommand)({
             label: "Create new instance",
             hint: "Clone Cursor with separate identity"
           },
+          {
+            value: "alias",
+            label: "Manage alias",
+            hint: existingInstances.length > 0 ? "Add or update shell alias for instance" : "No instances available"
+          },
           {
             value: "reinstall",
             label: "Reinstall instance",
@@ -2220,6 +2748,30 @@ var instanceCommand = (0, import_citty6.defineCommand)({
         process.exit(0);
       }
       action = actionResult;
+      if (action === "alias") {
+        if (existingInstances.length === 0) {
+          console.log();
+          printInfo("No custom Cursor instances found.");
+          console.log(import_picocolors8.default.dim("  Create an instance first."));
+          console.log();
+          p8.outro(import_picocolors8.default.dim("Nothing to do"));
+          return;
+        }
+        const instanceResult = await p8.select({
+          message: "Select instance to manage alias:",
+          options: existingInstances.map((inst) => ({
+            value: inst.name,
+            label: inst.alias ? `${inst.name} (alias: ${inst.alias})` : inst.name,
+            hint: inst.alias ? "Has alias" : "No alias"
+          }))
+        });
+        if (p8.isCancel(instanceResult)) {
+          p8.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        await handleAliasAction(instanceResult, args.alias, args.aliasLocation);
+        return;
+      }
     }
     if (args.name) {
       instanceName = args.name;
@@ -2229,7 +2781,7 @@ var instanceCommand = (0, import_citty6.defineCommand)({
         message: `Select instance to ${actionLabel2}:`,
         options: existingInstances.map((inst) => ({
           value: inst.name,
-          label: inst.name,
+          label: inst.alias ? `${inst.name} (alias: ${inst.alias})` : inst.name,
           hint: inst.path
         }))
       });
@@ -2277,12 +2829,16 @@ var instanceCommand = (0, import_citty6.defineCommand)({
       console.log(`  ${import_picocolors8.default.dim("Bundle ID:")} ${import_picocolors8.default.dim("com.cursor.")}${highlight(slug)}`);
       console.log(`  ${import_picocolors8.default.dim("Location:")}  ${import_picocolors8.default.dim("~/Applications/")}${highlight(instanceName + ".app")}`);
       if (action === "reinstall") {
-        const dataDir = (0, import_node_path9.join)(process.env.HOME ?? "", "Library", "Application Support", instanceName.replace(/ /g, ""));
+        const dataDir = (0, import_node_path10.join)(process.env.HOME ?? "", "Library", "Application Support", instanceName.replace(/ /g, ""));
         console.log(`  ${import_picocolors8.default.dim("Data:")}      ${import_picocolors8.default.green("\u2713")} ${import_picocolors8.default.dim("Preserved at")} ${import_picocolors8.default.dim(dataDir)}`);
       }
     } else {
-      const targetPath = (0, import_node_path9.join)(process.env.HOME ?? "", "Applications", `${instanceName}.app`);
+      const targetPath = (0, import_node_path10.join)(process.env.HOME ?? "", "Applications", `${instanceName}.app`);
       console.log(`  ${import_picocolors8.default.dim("Path:")}      ${import_picocolors8.default.dim(targetPath)}`);
+      const aliasEntry = getAliasForInstance(instanceName);
+      if (aliasEntry) {
+        console.log(`  ${import_picocolors8.default.dim("Alias:")}     ${import_picocolors8.default.yellow(aliasEntry.aliasName)} ${import_picocolors8.default.dim("(will be removed)")}`);
+      }
     }
     console.log();
     printDivider();
@@ -2307,6 +2863,20 @@ var instanceCommand = (0, import_citty6.defineCommand)({
     if (exitCode === 0) {
       if (action === "create") {
         printSuccess(`Instance ${highlight(instanceName)} created successfully!`);
+        if (!args.skipAlias) {
+          console.log();
+          const aliasConfig = await promptAliasCreation(
+            instanceName,
+            args.alias,
+            args.aliasLocation
+          );
+          if (aliasConfig) {
+            await handleAliasCreation(instanceName, aliasConfig.aliasName, aliasConfig.location);
+          }
+        } else if (args.alias) {
+          const location = args.aliasLocation ?? "shell-config";
+          await handleAliasCreation(instanceName, args.alias, location);
+        }
         console.log();
         console.log(import_picocolors8.default.dim("  Next steps:"));
         console.log(import_picocolors8.default.dim("  \u2022 The new instance should launch automatically"));
@@ -2320,6 +2890,7 @@ var instanceCommand = (0, import_citty6.defineCommand)({
         console.log(import_picocolors8.default.dim("  \u2022 Relaunched with your preserved data"));
         console.log(import_picocolors8.default.dim("  \u2022 Ready to use with your existing account"));
       } else {
+        await handleAliasRemoval(instanceName);
         printSuccess(`Instance ${highlight(instanceName)} removed successfully!`);
       }
       console.log();