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

package/dist/cli.js

@@ -1535,8 +1535,8 @@ async function convertPulledFilesForTarget(target, directories) {
       const skillPath = join6(skillsDir, skillDir);
       const skillMdPath = join6(skillPath, "SKILL.md");
       const skillMdcPath = join6(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");
@@ -2033,17 +2033,313 @@ import { defineCommand as defineCommand6 } from "citty";
 import * as p8 from "@clack/prompts";
 import pc8 from "picocolors";
 import { spawn } from "child_process";
-import { join as join9, dirname as dirname3 } from "path";
+import { join as join10, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { existsSync as existsSync2, chmodSync, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync3, chmodSync as chmodSync2, readdirSync as readdirSync2 } from "fs";
+
+// src/utils/alias.ts
+import {
+  appendFileSync,
+  chmodSync,
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync2,
+  unlinkSync,
+  writeFileSync as writeFileSync2
+} from "fs";
+import { homedir } from "os";
+import { join as join9 } from "path";
+var CURSOR_KIT_DIR = ".cursor-kit";
+var ALIASES_FILE = "aliases.json";
+function getAliasConfigDir() {
+  return join9(homedir(), CURSOR_KIT_DIR);
+}
+function getAliasConfigPath() {
+  return join9(getAliasConfigDir(), ALIASES_FILE);
+}
+function ensureConfigDir() {
+  const configDir = getAliasConfigDir();
+  if (!existsSync2(configDir)) {
+    mkdirSync2(configDir, { recursive: true });
+  }
+}
+function loadAliasConfig() {
+  const configPath = getAliasConfigPath();
+  if (!existsSync2(configPath)) {
+    return { aliases: {} };
+  }
+  try {
+    const content = readFileSync2(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return { aliases: {} };
+  }
+}
+function saveAliasConfig(config) {
+  ensureConfigDir();
+  const configPath = getAliasConfigPath();
+  writeFileSync2(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function getInstanceDataDir(instanceName) {
+  return join9(
+    homedir(),
+    "Library",
+    "Application Support",
+    instanceName.replace(/ /g, "")
+  );
+}
+function getInstanceAppPath(instanceName) {
+  return join9(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 = homedir();
+  const shell = process.env.SHELL ?? "/bin/zsh";
+  if (shell.includes("zsh")) {
+    return join9(home, ".zshrc");
+  }
+  if (shell.includes("bash")) {
+    const bashProfile = join9(home, ".bash_profile");
+    if (existsSync2(bashProfile)) {
+      return bashProfile;
+    }
+    return join9(home, ".bashrc");
+  }
+  return join9(home, ".zshrc");
+}
+function getHomeBinDir() {
+  return join9(homedir(), "bin");
+}
+function getUsrLocalBinDir() {
+  return "/usr/local/bin";
+}
+function ensureBinDir(binDir) {
+  if (!existsSync2(binDir)) {
+    mkdirSync2(binDir, { recursive: true });
+  }
+}
+function createExecutableScript(aliasName, instanceName, targetDir) {
+  ensureBinDir(targetDir);
+  const scriptPath = join9(targetDir, aliasName);
+  const scriptContent = generateScriptContent(instanceName);
+  writeFileSync2(scriptPath, scriptContent, "utf-8");
+  chmodSync(scriptPath, 493);
+  return scriptPath;
+}
+function createShellAlias(aliasName, instanceName, shellConfigPath) {
+  const functionContent = generateShellFunction(aliasName, instanceName);
+  if (!existsSync2(shellConfigPath)) {
+    writeFileSync2(shellConfigPath, "", "utf-8");
+  }
+  const existingContent = readFileSync2(shellConfigPath, "utf-8");
+  if (existingContent.includes(`# cursor-kit alias: ${aliasName}`)) {
+    removeShellAlias(aliasName, shellConfigPath);
+  }
+  appendFileSync(shellConfigPath, functionContent, "utf-8");
+}
+function removeShellAlias(aliasName, shellConfigPath) {
+  if (!existsSync2(shellConfigPath)) {
+    return false;
+  }
+  const content = readFileSync2(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");
+  writeFileSync2(shellConfigPath, newContent, "utf-8");
+  return true;
+}
+function removeExecutableScript(scriptPath) {
+  if (!existsSync2(scriptPath)) {
+    return false;
+  }
+  try {
+    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 = join9(getUsrLocalBinDir(), aliasName);
+      removed = removeExecutableScript(scriptPath);
+      break;
+    }
+    case "home-bin": {
+      const scriptPath = join9(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 = dirname3(fileURLToPath2(import.meta.url));
   const possiblePaths = [
-    join9(currentDir, "..", "..", "bin"),
-    join9(currentDir, "..", "bin")
+    join10(currentDir, "..", "..", "bin"),
+    join10(currentDir, "..", "bin")
   ];
   for (const binPath of possiblePaths) {
-    if (existsSync2(binPath)) {
+    if (existsSync3(binPath)) {
       return binPath;
     }
   }
@@ -2051,19 +2347,24 @@ function getBinPath() {
 }
 function ensureExecutable(scriptPath) {
   try {
-    chmodSync(scriptPath, 493);
+    chmodSync2(scriptPath, 493);
   } catch {
   }
 }
 function getExistingInstances() {
-  const userAppsDir = join9(process.env.HOME ?? "", "Applications");
-  if (!existsSync2(userAppsDir)) return [];
+  const userAppsDir = join10(process.env.HOME ?? "", "Applications");
+  if (!existsSync3(userAppsDir)) return [];
   try {
     const apps = readdirSync2(userAppsDir);
-    return apps.filter((app) => app.startsWith("Cursor") && app.endsWith(".app") && app !== "Cursor.app").map((app) => ({
-      name: app.replace(".app", ""),
-      path: join9(userAppsDir, app)
-    }));
+    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: join10(userAppsDir, app),
+        alias: aliasEntry?.aliasName
+      };
+    });
   } catch {
     return [];
   }
@@ -2082,6 +2383,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(pc8.dim(`  \u2514\u2500 Location: ${getStorageLocationLabel(location)}`));
+  if (location === "home-bin" && !isHomeBinInPath()) {
+    console.log();
+    printWarning("~/bin is not in your PATH");
+    console.log(pc8.dim(getPathSetupInstructions()));
+  }
+  if (location === "shell-config") {
+    console.log();
+    console.log(pc8.dim("  Restart your terminal or run:"));
+    console.log(pc8.dim(`  source ${detectShellConfigPath()}`));
+  }
+  console.log();
+  console.log(pc8.dim("  Usage:"));
+  console.log(pc8.dim(`  ${aliasName} .              # Open current directory`));
+  console.log(pc8.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(pc8.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(pc8.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(pc8.green("\u2728 Done!"));
+      } else {
+        printWarning(`Could not remove alias ${existingAlias.aliasName}`);
+        p8.outro(pc8.yellow("Check file permissions"));
+      }
+      return;
+    }
+    removeAlias(existingAlias.aliasName);
+  }
+  const aliasConfig = await promptAliasCreation(
+    instanceName,
+    providedAlias,
+    providedLocation,
+    true
+  );
+  if (!aliasConfig) {
+    p8.outro(pc8.dim("Alias creation cancelled"));
+    return;
+  }
+  const success = await handleAliasCreation(instanceName, aliasConfig.aliasName, aliasConfig.location);
+  if (success) {
+    console.log();
+    p8.outro(pc8.green("\u2728 Done!"));
+  } else {
+    p8.outro(pc8.yellow("Alias creation failed"));
+  }
+}
 var instanceCommand = defineCommand6({
   meta: {
     name: "instance",
@@ -2091,7 +2566,7 @@ var instanceCommand = defineCommand6({
     action: {
       type: "string",
       alias: "a",
-      description: "Action: 'create', 'reinstall', or 'remove'"
+      description: "Action: 'create', 'reinstall', 'remove', or 'alias'"
     },
     name: {
       type: "string",
@@ -2103,6 +2578,20 @@ var instanceCommand = defineCommand6({
       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 }) {
@@ -2126,7 +2615,8 @@ var instanceCommand = defineCommand6({
         console.log(pc8.bold(pc8.cyan("  \u{1F5A5}  Cursor Instances")) + pc8.dim(` (${instances.length})`));
         console.log();
         for (const instance of instances) {
-          console.log(`  ${pc8.green("\u25CF")} ${highlight(instance.name)}`);
+          const aliasInfo = instance.alias ? pc8.dim(` (alias: ${pc8.cyan(instance.alias)})`) : "";
+          console.log(`  ${pc8.green("\u25CF")} ${highlight(instance.name)}${aliasInfo}`);
           console.log(pc8.dim(`    \u2514\u2500 ${instance.path}`));
         }
       }
@@ -2135,13 +2625,55 @@ var instanceCommand = defineCommand6({
       p8.outro(pc8.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(pc8.dim("  Create an instance first with: ") + highlight("cursor-kit instance -a create"));
+        console.log();
+        p8.outro(pc8.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(pc8.dim("  Available instances:"));
+          for (const inst of existingInstances) {
+            console.log(pc8.dim(`    \u2022 ${inst.name}`));
+          }
+          console.log();
+          p8.outro(pc8.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 = join9(binPath, "cursor-new-instance");
-    const removeScript = join9(binPath, "cursor-remove-instance");
-    const reinstallScript = join9(binPath, "cursor-reinstall-instance.sh");
-    const scriptsExist = existsSync2(createScript) && existsSync2(removeScript) && existsSync2(reinstallScript);
+    const createScript = join10(binPath, "cursor-new-instance");
+    const removeScript = join10(binPath, "cursor-remove-instance");
+    const reinstallScript = join10(binPath, "cursor-reinstall-instance.sh");
+    const scriptsExist = existsSync3(createScript) && existsSync3(removeScript) && existsSync3(reinstallScript);
     if (!scriptsExist) {
       s.stop("Prerequisites check failed");
       console.log();
@@ -2152,7 +2684,7 @@ var instanceCommand = defineCommand6({
       process.exit(1);
     }
     const originalCursor = "/Applications/Cursor.app";
-    if (!existsSync2(originalCursor)) {
+    if (!existsSync3(originalCursor)) {
       s.stop("Prerequisites check failed");
       console.log();
       printWarning("Cursor.app not found in /Applications");
@@ -2162,7 +2694,6 @@ var instanceCommand = defineCommand6({
       process.exit(1);
     }
     s.stop("Prerequisites verified");
-    const existingInstances = getExistingInstances();
     let action;
     let instanceName;
     if (args.action && ["create", "remove", "reinstall"].includes(args.action)) {
@@ -2176,6 +2707,11 @@ var instanceCommand = defineCommand6({
             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",
@@ -2193,6 +2729,30 @@ var instanceCommand = defineCommand6({
         process.exit(0);
       }
       action = actionResult;
+      if (action === "alias") {
+        if (existingInstances.length === 0) {
+          console.log();
+          printInfo("No custom Cursor instances found.");
+          console.log(pc8.dim("  Create an instance first."));
+          console.log();
+          p8.outro(pc8.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;
@@ -2202,7 +2762,7 @@ var instanceCommand = defineCommand6({
         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
         }))
       });
@@ -2250,12 +2810,16 @@ var instanceCommand = defineCommand6({
       console.log(`  ${pc8.dim("Bundle ID:")} ${pc8.dim("com.cursor.")}${highlight(slug)}`);
       console.log(`  ${pc8.dim("Location:")}  ${pc8.dim("~/Applications/")}${highlight(instanceName + ".app")}`);
       if (action === "reinstall") {
-        const dataDir = join9(process.env.HOME ?? "", "Library", "Application Support", instanceName.replace(/ /g, ""));
+        const dataDir = join10(process.env.HOME ?? "", "Library", "Application Support", instanceName.replace(/ /g, ""));
         console.log(`  ${pc8.dim("Data:")}      ${pc8.green("\u2713")} ${pc8.dim("Preserved at")} ${pc8.dim(dataDir)}`);
       }
     } else {
-      const targetPath = join9(process.env.HOME ?? "", "Applications", `${instanceName}.app`);
+      const targetPath = join10(process.env.HOME ?? "", "Applications", `${instanceName}.app`);
       console.log(`  ${pc8.dim("Path:")}      ${pc8.dim(targetPath)}`);
+      const aliasEntry = getAliasForInstance(instanceName);
+      if (aliasEntry) {
+        console.log(`  ${pc8.dim("Alias:")}     ${pc8.yellow(aliasEntry.aliasName)} ${pc8.dim("(will be removed)")}`);
+      }
     }
     console.log();
     printDivider();
@@ -2280,6 +2844,20 @@ var instanceCommand = defineCommand6({
     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(pc8.dim("  Next steps:"));
         console.log(pc8.dim("  \u2022 The new instance should launch automatically"));
@@ -2293,6 +2871,7 @@ var instanceCommand = defineCommand6({
         console.log(pc8.dim("  \u2022 Relaunched with your preserved data"));
         console.log(pc8.dim("  \u2022 Ready to use with your existing account"));
       } else {
+        await handleAliasRemoval(instanceName);
         printSuccess(`Instance ${highlight(instanceName)} removed successfully!`);
       }
       console.log();