@coreify/quitx 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 1.1.0
+
+### Added
+
+- Group background instances option (`groupBackground`, default `true`) to aggregate duplicate background helper processes into one entry with count and terminate all PIDs upon quitting.
+- Never quit music apps protection (`neverQuitMusic`) with hybrid detection: macOS category `public.app-category.music`, bundle IDs, well-known music apps (Spotify, Apple Music, Tidal, Cider, Vox, etc.), and custom music apps.
+- Interactive custom music app management (`musicApps`) in configuration menu.
+- Deselect apps by default option (`defaultSelectAll`) to start interactive picker with no apps pre-selected.
+- Include Empty Trash in list option (`includeTrash`) with explicit warning that quitting permanently and irreversibly deletes macOS Trash.
+- Cleaner, intuitive configuration menu options aligned with native preferences.
+
+### Fixed
+
+- Fixed Windows silent exit: normalized path separators in CLI entry point detection so Windows/Linux platforms cleanly print OS guard error (`✖ quitx only works on macOS. Windows and Linux are not supported.`) with exit code 1.
+- Unified running app discovery across home selector and exclude/music add menus.
+- Handled multi-PID termination cleanly when quitting grouped background instances.
+
 ## 1.0.0
 
 ### Added

package/dist/cli.js

@@ -6,7 +6,6 @@ import { homedir } from 'os';
 import { join } from 'path';
 import { execa } from 'execa';
 import { spawn } from 'child_process';
-import { MultiSelectPrompt } from '@clack/core';
 
 var CONFIG_DIR = join(homedir(), ".quitx");
 var CONFIG_FILE = join(CONFIG_DIR, "config.json");
@@ -14,27 +13,40 @@ var DEFAULT_CONFIG = {
   exclude: [],
   force: "normal",
   includeFinder: false,
-  includeBackground: false
+  includeTrash: false,
+  includeBackground: false,
+  groupBackground: true,
+  defaultSelectAll: true,
+  neverQuitMusic: false,
+  musicApps: []
 };
 function loadConfig(filePath = CONFIG_FILE) {
   try {
     if (!existsSync(filePath)) {
-      return { ...DEFAULT_CONFIG, exclude: [] };
+      return { ...DEFAULT_CONFIG, exclude: [], musicApps: [] };
     }
     const raw = readFileSync(filePath, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null) {
-      return { ...DEFAULT_CONFIG, exclude: [] };
+      return { ...DEFAULT_CONFIG, exclude: [], musicApps: [] };
     }
     const obj = parsed;
+    const defaultSelectVal = typeof obj.defaultSelectAll === "boolean" ? obj.defaultSelectAll : obj.defaultSelect === "deselect-all" || obj.defaultSelection === "deselect-all" || obj.defaultSelect === false ? false : typeof obj.defaultSelect === "boolean" ? obj.defaultSelect : DEFAULT_CONFIG.defaultSelectAll;
+    const groupBgVal = typeof obj.groupBackground === "boolean" ? obj.groupBackground : typeof obj.groupBackgroundInstances === "boolean" ? obj.groupBackgroundInstances : DEFAULT_CONFIG.groupBackground;
+    const neverQuitMusicVal = typeof obj.neverQuitMusic === "boolean" ? obj.neverQuitMusic : DEFAULT_CONFIG.neverQuitMusic;
     return {
       exclude: Array.isArray(obj.exclude) ? obj.exclude : [],
       force: obj.force === "force" || obj.force === "normal" ? obj.force : DEFAULT_CONFIG.force,
       includeFinder: typeof obj.includeFinder === "boolean" ? obj.includeFinder : DEFAULT_CONFIG.includeFinder,
-      includeBackground: typeof obj.includeBackground === "boolean" ? obj.includeBackground : DEFAULT_CONFIG.includeBackground
+      includeTrash: typeof obj.includeTrash === "boolean" ? obj.includeTrash : DEFAULT_CONFIG.includeTrash,
+      includeBackground: typeof obj.includeBackground === "boolean" ? obj.includeBackground : DEFAULT_CONFIG.includeBackground,
+      groupBackground: groupBgVal,
+      defaultSelectAll: defaultSelectVal,
+      neverQuitMusic: neverQuitMusicVal,
+      musicApps: Array.isArray(obj.musicApps) ? obj.musicApps : DEFAULT_CONFIG.musicApps
     };
   } catch {
-    return { ...DEFAULT_CONFIG, exclude: [] };
+    return { ...DEFAULT_CONFIG, exclude: [], musicApps: [] };
   }
 }
 function saveConfig(config, filePath = CONFIG_FILE) {
@@ -72,6 +84,31 @@ function removeExcludedApps(apps, filePath = CONFIG_FILE) {
   saveConfig(next, filePath);
   return next;
 }
+function addMusicApps(apps, filePath = CONFIG_FILE) {
+  const current = loadConfig(filePath);
+  const set = new Set(current.musicApps.map((a) => a.toLowerCase().trim()));
+  const updated = [...current.musicApps];
+  for (const app of apps) {
+    const trimmed = app.trim();
+    if (trimmed && !set.has(trimmed.toLowerCase())) {
+      set.add(trimmed.toLowerCase());
+      updated.push(trimmed);
+    }
+  }
+  const next = { ...current, musicApps: updated };
+  saveConfig(next, filePath);
+  return next;
+}
+function removeMusicApps(apps, filePath = CONFIG_FILE) {
+  const current = loadConfig(filePath);
+  const toRemove = new Set(apps.map((a) => a.toLowerCase().trim()));
+  const updated = current.musicApps.filter(
+    (app) => !toRemove.has(app.toLowerCase().trim())
+  );
+  const next = { ...current, musicApps: updated };
+  saveConfig(next, filePath);
+  return next;
+}
 
 // src/macos/jxa.ts
 var APPKIT_PREAMBLE = "ObjC.import('AppKit');";
@@ -98,6 +135,10 @@ async function runJXA(script, args = [], executor = execa) {
   ]);
   return stdout.trim();
 }
+async function runAppleScript(script, executor = execa) {
+  const { stdout } = await executor("osascript", ["-e", script]);
+  return stdout.trim();
+}
 
 // src/macos/apps.ts
 function buildDiscoveryScript(includeBackground = false) {
@@ -114,7 +155,18 @@ function run() {
     const name = app.localizedName ? app.localizedName.js : '';
     const bundleId = app.bundleIdentifier ? app.bundleIdentifier.js : '';
     const pid = String(app.processIdentifier);
-    lines.push(name + '\\t' + bundleId + '\\t' + pid);
+    const isBg = app.activationPolicy !== Regular ? '1' : '0';
+    let isMusic = '0';
+    if (app.bundleURL) {
+      const bundle = $.NSBundle.bundleWithURL(app.bundleURL);
+      if (bundle && bundle.infoDictionary) {
+        const cat = bundle.infoDictionary.objectForKey('LSApplicationCategoryType');
+        if (cat && cat.js === 'public.app-category.music') {
+          isMusic = '1';
+        }
+      }
+    }
+    lines.push(name + '\\t' + bundleId + '\\t' + pid + '\\t' + isBg + '\\t' + isMusic);
   }
   return lines.join('\\n');
 }`.trim();
@@ -148,35 +200,104 @@ function parseAppListOutput(stdout) {
     const results = [];
     for (const line of lines) {
       const parts = line.split("	");
-      const rawName = parts[0]?.trim();
+      const rawName = parts[0]?.replace(/[\u200B-\u200D\u200E\u200F\uFEFF]/g, "").trim();
       if (!rawName) continue;
       const rawBundle = parts[1]?.trim();
       const bundleId = rawBundle && rawBundle !== "missing value" && rawBundle.length > 0 ? rawBundle : void 0;
       const rawPid = parts[2]?.trim();
       const pidNum = rawPid ? parseInt(rawPid, 10) : void 0;
       const pid = !Number.isNaN(pidNum) && pidNum !== void 0 && pidNum > 0 ? pidNum : void 0;
+      const rawIsBg = parts[3]?.trim();
+      const isBackground = rawIsBg === "1";
+      const rawIsMusic = parts[4]?.trim();
+      const isMusic = rawIsMusic === "1";
       let name = rawName;
       if (bundleId && rawName === bundleId) {
         name = formatDynamicName(bundleId);
       }
-      results.push({ name, bundleId, pid });
+      results.push({
+        name,
+        bundleId,
+        pid,
+        ...isBackground ? { isBackground: true } : {},
+        ...isMusic ? { isMusic: true } : {}
+      });
     }
     return results;
   }
-  return trimmed.split(",").map((name) => name.trim()).filter(Boolean).map((name) => ({ name }));
+  return trimmed.split(",").map(
+    (name) => name.replace(/[\u200B-\u200D\u200E\u200F\uFEFF]/g, "").trim()
+  ).filter(Boolean).map((name) => ({ name }));
 }
 function sortApps(apps) {
   return [...apps].sort(
     (a, b) => a.name.localeCompare(b.name, void 0, { sensitivity: "base" })
   );
 }
+var KNOWN_MUSIC_BUNDLE_IDS = /* @__PURE__ */ new Set([
+  "com.apple.music",
+  "com.spotify.client",
+  "com.tidal.desktop",
+  "com.github.th-ch.youtube-music",
+  "app.ytmdesktop.ytmdesktop",
+  "com.amazon.music",
+  "com.deezer.deezer-desktop",
+  "com.coppertino.vox",
+  "com.audirvana.audirvana-plus",
+  "com.audirvana.audirvana",
+  "com.swinsian.swinsian",
+  "cider.sh",
+  "com.cider.cider"
+]);
+var KNOWN_MUSIC_APP_NAMES = /* @__PURE__ */ new Set([
+  "music",
+  "apple music",
+  "spotify",
+  "tidal",
+  "youtube music",
+  "amazon music",
+  "deezer",
+  "qobuz",
+  "soundcloud",
+  "pandora",
+  "vox",
+  "audirvana",
+  "foobar2000",
+  "swinsian",
+  "cider"
+]);
+function isMusicApp(app, customMusicApps = []) {
+  if (app.isMusic) {
+    return true;
+  }
+  const nameLower = app.name.toLowerCase().trim();
+  const bundleLower = app.bundleId?.toLowerCase().trim();
+  if (bundleLower && KNOWN_MUSIC_BUNDLE_IDS.has(bundleLower)) {
+    return true;
+  }
+  if (KNOWN_MUSIC_APP_NAMES.has(nameLower)) {
+    return true;
+  }
+  if (customMusicApps.length > 0) {
+    const customSet = new Set(
+      customMusicApps.map((a) => a.toLowerCase().trim())
+    );
+    if (customSet.has(nameLower) || bundleLower && customSet.has(bundleLower)) {
+      return true;
+    }
+  }
+  return false;
+}
 function filterApps(apps, optionsOrExclude = {}) {
   const opts = Array.isArray(optionsOrExclude) ? { exclude: optionsOrExclude } : optionsOrExclude;
   const exclude = opts.exclude ?? [];
   const includeFinder = opts.includeFinder ?? false;
-  const seen = /* @__PURE__ */ new Set();
+  const includeTrash = opts.includeTrash ?? false;
+  const groupBackground = opts.groupBackground ?? true;
+  const neverQuitMusic = opts.neverQuitMusic ?? false;
+  const customMusicApps = opts.musicApps ?? [];
   const excludeSet = new Set(exclude.map((e) => e.toLowerCase().trim()));
-  const filtered = [];
+  const eligible = [];
   for (const app of apps) {
     const nameLower = app.name.toLowerCase().trim();
     const bundleLower = app.bundleId?.toLowerCase().trim();
@@ -188,23 +309,73 @@ function filterApps(apps, optionsOrExclude = {}) {
         continue;
       }
     }
-    if (excludeSet.has(nameLower) || bundleLower && excludeSet.has(bundleLower)) {
+    if (!includeTrash) {
+      if (nameLower === "trash" || bundleLower === "com.apple.trash") {
+        continue;
+      }
+    }
+    if (neverQuitMusic && isMusicApp(app, customMusicApps)) {
       continue;
     }
-    const key = bundleLower ?? nameLower;
-    if (seen.has(key)) {
+    if (excludeSet.has(nameLower) || bundleLower && excludeSet.has(bundleLower)) {
       continue;
     }
-    seen.add(key);
-    filtered.push(app);
+    eligible.push(app);
   }
-  return sortApps(filtered);
+  const result = [];
+  const grouped = /* @__PURE__ */ new Map();
+  for (const app of eligible) {
+    const nameLower = app.name.toLowerCase().trim();
+    const bundleLower = app.bundleId?.toLowerCase().trim();
+    const isBg = app.isBackground === true;
+    if (isBg && !groupBackground) {
+      result.push({ ...app });
+    } else {
+      let key = bundleLower ?? nameLower;
+      let cleanName = app.name;
+      if (isBg) {
+        const base = app.name.replace(/\s*\([^)]*\)$/, "").trim();
+        if (base) {
+          key = base.toLowerCase();
+          cleanName = base;
+        }
+      }
+      const existing = grouped.get(key);
+      if (existing) {
+        if (app.pid) {
+          if (!existing.pids) {
+            existing.pids = existing.pid ? [existing.pid] : [];
+          }
+          if (!existing.pids.includes(app.pid)) {
+            existing.pids.push(app.pid);
+          }
+          existing.count = existing.pids.length;
+        } else {
+          existing.count = (existing.count ?? 1) + 1;
+        }
+      } else {
+        const item = { ...app, name: cleanName };
+        grouped.set(key, item);
+        result.push(item);
+      }
+    }
+  }
+  if (includeTrash && !excludeSet.has("trash") && !excludeSet.has("com.apple.trash")) {
+    const hasTrash = result.some(
+      (a) => a.name.toLowerCase() === "trash" || a.bundleId?.toLowerCase() === "com.apple.trash"
+    );
+    if (!hasTrash) {
+      result.push({ name: "Trash", bundleId: "com.apple.trash" });
+    }
+  }
+  return sortApps(result);
 }
 async function getRunningApps(optionsOrExclude, executor) {
   let exec;
-  let filterOpts = {};
+  let filterOpts;
   let includeBackground = false;
   if (typeof optionsOrExclude === "function") {
+    filterOpts = {};
     exec = optionsOrExclude;
   } else if (Array.isArray(optionsOrExclude)) {
     filterOpts = { exclude: optionsOrExclude };
@@ -213,11 +384,25 @@ async function getRunningApps(optionsOrExclude, executor) {
     const opts = optionsOrExclude;
     filterOpts = {
       exclude: opts.exclude ?? [],
-      includeFinder: opts.includeFinder ?? false
+      includeFinder: opts.includeFinder ?? false,
+      includeTrash: opts.includeTrash ?? false,
+      groupBackground: opts.groupBackground ?? true,
+      neverQuitMusic: opts.neverQuitMusic ?? false,
+      musicApps: opts.musicApps ?? []
     };
     includeBackground = opts.includeBackground ?? false;
     exec = executor;
   } else {
+    const config = loadConfig();
+    filterOpts = {
+      exclude: config.exclude,
+      includeFinder: config.includeFinder,
+      includeTrash: config.includeTrash,
+      groupBackground: config.groupBackground,
+      neverQuitMusic: config.neverQuitMusic,
+      musicApps: config.musicApps
+    };
+    includeBackground = config.includeBackground;
     exec = executor;
   }
   const script = buildDiscoveryScript(includeBackground);
@@ -240,8 +425,19 @@ async function isAppRunning(target, executor) {
   if (typeof target === "number") {
     return isProcessAlive(target);
   }
-  if (typeof target === "object" && target.pid !== void 0 && target.pid > 0) {
-    return isProcessAlive(target.pid);
+  if (typeof target === "object") {
+    if (target.bundleId === "com.apple.trash" || target.name.toLowerCase() === "trash") {
+      return false;
+    }
+    if (target.pids && target.pids.length > 0) {
+      return target.pids.some((pid) => isProcessAlive(pid));
+    }
+    if (target.pid !== void 0 && target.pid > 0) {
+      return isProcessAlive(target.pid);
+    }
+  }
+  if (typeof target === "string" && (target.toLowerCase() === "trash" || target.toLowerCase() === "com.apple.trash")) {
+    return false;
   }
   const name = typeof target === "string" ? target : target.name;
   const bundleId = typeof target === "object" ? target.bundleId ?? "" : "";
@@ -353,13 +549,32 @@ function isCurrentTerminalApp(app, env = process.env) {
 }
 
 // src/macos/quit.ts
+var EMPTY_TRASH_SCRIPT = `
+ignoring application responses
+    tell application "Finder"
+        try
+            set warns before emptying to false
+            empty the trash
+        end try
+    end tell
+end ignoring
+`.trim();
 var QUIT_JXA_SCRIPT = buildAppMatcherScript(`
 const bundleId = argv[0] || '';
 const name = argv[1] || '';
+const pidStr = argv[2] || '';
+const targetPid = pidStr ? parseInt(pidStr, 10) : 0;
 const bid = app.bundleIdentifier ? app.bundleIdentifier.js : '';
 const nm = app.localizedName ? app.localizedName.js : '';
-if ((bundleId && bid === bundleId) || (name && nm === name)) {
-  return String(app.terminate());
+const appPid = app.processIdentifier;
+
+const matches = targetPid
+  ? appPid === targetPid
+  : ((bundleId && bid === bundleId) || (name && nm.toLowerCase() === name.toLowerCase()));
+
+if (matches) {
+  const res = typeof app.terminate === 'function' ? app.terminate() : app.terminate;
+  return String(res);
 }
 `);
 function shellQuote(value) {
@@ -368,7 +583,9 @@ function shellQuote(value) {
 function defaultDeferredQuitScheduler(app, force = false) {
   try {
     const bundleId = app.bundleId ?? "";
-    const cmd = force && app.pid ? `sleep 0.4 && kill -9 ${app.pid}` : `sleep 0.4 && osascript -l JavaScript -e ${shellQuote(QUIT_JXA_SCRIPT)} ${shellQuote(bundleId)} ${shellQuote(app.name)}`;
+    const pids = app.pids && app.pids.length > 0 ? app.pids : app.pid ? [app.pid] : [];
+    const pidArg = app.pid ? ` ${shellQuote(String(app.pid))}` : "";
+    const cmd = force && pids.length > 0 ? `sleep 0.4 && kill -9 ${pids.join(" ")}` : `sleep 0.4 && osascript -l JavaScript -e ${shellQuote(QUIT_JXA_SCRIPT)} ${shellQuote(bundleId)} ${shellQuote(app.name)}${pidArg}`;
     const child = spawn("sh", ["-c", cmd], {
       detached: true,
       stdio: "ignore"
@@ -378,16 +595,48 @@ function defaultDeferredQuitScheduler(app, force = false) {
   }
 }
 async function sendQuitSignal(app, executor) {
-  const res = await runJXA(
-    QUIT_JXA_SCRIPT,
-    [app.bundleId ?? "", app.name],
-    executor
-  );
+  if (app.bundleId === "com.apple.trash" || app.name.toLowerCase() === "trash") {
+    await runAppleScript(EMPTY_TRASH_SCRIPT, executor);
+    return;
+  }
+  if (app.pids && app.pids.length > 1) {
+    let anyQuit = false;
+    for (const pid of app.pids) {
+      const args2 = [app.bundleId ?? "", app.name, String(pid)];
+      try {
+        const res2 = await runJXA(QUIT_JXA_SCRIPT, args2, executor);
+        if (res2.trim().toLowerCase() === "true") {
+          anyQuit = true;
+        }
+      } catch {
+      }
+    }
+    if (!anyQuit) {
+      throw new Error(`Could not quit "${app.name}"`);
+    }
+    return;
+  }
+  const args = [app.bundleId ?? "", app.name];
+  if (app.pid && app.pid > 0) {
+    args.push(String(app.pid));
+  }
+  const res = await runJXA(QUIT_JXA_SCRIPT, args, executor);
   if (res.trim().toLowerCase() !== "true") {
     throw new Error(`Could not quit "${app.name}"`);
   }
 }
 function forceQuitApp(app) {
+  if (app.pids && app.pids.length > 0) {
+    let anyKilled = false;
+    for (const pid of app.pids) {
+      try {
+        process.kill(pid, "SIGKILL");
+        anyKilled = true;
+      } catch {
+      }
+    }
+    return anyKilled;
+  }
   if (app.pid && app.pid > 0) {
     try {
       process.kill(app.pid, "SIGKILL");
@@ -398,6 +647,7 @@ function forceQuitApp(app) {
   }
   return false;
 }
+var DEFAULT_QUIT_TIMEOUT_MS = 8e3;
 async function quitApps(apps, options = {}, executor, deferredScheduler = defaultDeferredQuitScheduler) {
   if (apps.length === 0) {
     return [];
@@ -413,21 +663,33 @@ async function quitApps(apps, options = {}, executor, deferredScheduler = defaul
   }
   const results = [];
   if (otherApps.length > 0) {
-    const timeoutMs = options.timeoutMs ?? 700;
+    const maxTimeoutMs = options.timeoutMs ?? DEFAULT_QUIT_TIMEOUT_MS;
+    const pollIntervalMs = Math.min(150, maxTimeoutMs);
     await Promise.allSettled(
       otherApps.map((app) => sendQuitSignal(app, executor))
     );
-    await sleep(timeoutMs);
-    for (const app of otherApps) {
-      const stillRunning = await isAppRunning(app, executor);
-      if (!stillRunning) {
-        results.push({ app, success: true, forced: false });
-        continue;
+    const pending = /* @__PURE__ */ new Map();
+    for (let i = 0; i < otherApps.length; i++) {
+      const app = otherApps[i];
+      const key = app.pid ?? `idx_${i}_${app.name}`;
+      pending.set(key, app);
+    }
+    const start = Date.now();
+    while (pending.size > 0 && Date.now() - start <= maxTimeoutMs) {
+      await sleep(pollIntervalMs);
+      for (const [key, app] of Array.from(pending.entries())) {
+        const stillRunning = await isAppRunning(app, executor);
+        if (!stillRunning) {
+          results.push({ app, success: true, forced: false });
+          pending.delete(key);
+        }
       }
+    }
+    for (const app of pending.values()) {
       if (options.force) {
         const killed = forceQuitApp(app);
         if (killed) {
-          await sleep(100);
+          await sleep(150);
           const aliveAfterForce = await isAppRunning(app, executor);
           if (!aliveAfterForce) {
             results.push({ app, success: true, forced: true });
@@ -504,6 +766,7 @@ OPTIONS:
   -f, --force             Force quit apps (SIGKILL) if normal quit fails
   -b, --background        Include background processes in app list
       --include-finder    Include Finder in the app list
+      --include-trash     Include Trash in the app list (empties on quit)
       --exclude <apps>    Add apps to persistent exclude list (comma-separated)
       --config            Open interactive config manager
       --json              Output data in JSON format
@@ -531,7 +794,7 @@ EXAMPLES:
 function renderVersion(version) {
   console.log(`quitx v${version}`);
 }
-var THANKS_MESSAGE = "\nThanks for using quitx..!";
+var THANKS_MESSAGE = "\nThanks for using quitx..!\nFor more visit - quitx.js.org";
 function printThanks(options) {
   if (options?.json || options?.quiet) return;
   console.log(THANKS_MESSAGE);
@@ -541,125 +804,40 @@ var BACK_VALUE = "back";
 function backOption() {
   return { value: BACK_VALUE, label: "Back to main menu" };
 }
-function handleQuitAllToggle(currentValue, selectedValues) {
-  if (currentValue === SELECT_ALL_VALUE) {
-    if (selectedValues.includes(SELECT_ALL_VALUE)) {
-      return [];
-    }
-    return [SELECT_ALL_VALUE];
-  }
-  if (selectedValues.includes(SELECT_ALL_VALUE)) {
-    return [...selectedValues];
-  }
-  const isSelected = selectedValues.includes(currentValue);
-  return isSelected ? selectedValues.filter((v) => v !== currentValue) : [...selectedValues, currentValue];
-}
-function attachQuitAllBehavior(prompt) {
-  let _cursor = prompt.cursor ?? 0;
-  let _value = prompt.value ? [...prompt.value] : [];
-  Object.defineProperty(prompt, "cursor", {
-    get() {
-      return _cursor;
-    },
-    set(val) {
-      if (_value.includes(SELECT_ALL_VALUE)) {
-        _cursor = 0;
-      } else {
-        _cursor = val;
-      }
-    },
-    configurable: true
-  });
-  Object.defineProperty(prompt, "value", {
-    get() {
-      return _value;
-    },
-    set(val) {
-      if (!Array.isArray(val)) {
-        _value = [];
-        return;
-      }
-      if (val.includes(SELECT_ALL_VALUE)) {
-        _value = [SELECT_ALL_VALUE];
-        _cursor = 0;
-      } else {
-        _value = val.filter((v) => v !== SELECT_ALL_VALUE);
-      }
-    },
-    configurable: true
-  });
-  prompt.toggleValue = function() {
-    const cur = prompt.options[prompt.cursor ?? 0]?.value;
-    if (!cur) return;
-    prompt.value = handleQuitAllToggle(cur, prompt.value ?? []);
-  };
-  prompt.toggleAll = function() {
-    if (prompt.value?.includes(SELECT_ALL_VALUE)) {
-      prompt.value = [];
-    } else {
-      prompt.value = [SELECT_ALL_VALUE];
-    }
-  };
-  prompt.toggleInvert = function() {
-    if (prompt.value?.includes(SELECT_ALL_VALUE)) {
-      prompt.value = [];
-    } else {
-      prompt.value = [SELECT_ALL_VALUE];
-    }
-  };
-}
-async function selectApps(apps) {
+async function selectApps(apps, options = {}) {
   if (apps.length === 0) {
     return [];
   }
-  const appOptions = apps.map((app) => {
-    const hint = app.bundleId ?? (app.pid ? `PID: ${app.pid}` : void 0);
+  const bundleCounts = /* @__PURE__ */ new Map();
+  for (const app of apps) {
+    const k = app.bundleId ?? app.name;
+    bundleCounts.set(k, (bundleCounts.get(k) ?? 0) + 1);
+  }
+  const appOptions = apps.map((app, index) => {
+    let hint = app.bundleId ?? (app.pid ? `PID: ${app.pid}` : void 0);
+    if (app.count && app.count > 1) {
+      hint = app.bundleId ? `${app.bundleId} (${app.count} instances)` : `${app.count} instances`;
+    } else if (app.pid && app.isBackground) {
+      hint = app.bundleId ? `${app.bundleId} (PID: ${app.pid})` : `PID: ${app.pid}`;
+    }
+    const base = app.bundleId ?? app.name;
+    const isDup = (bundleCounts.get(base) ?? 0) > 1;
+    const value = isDup && app.pid ? `${base}:${app.pid}` : app.bundleId ?? `${app.name}-${app.pid ?? index}`;
+    const label = app.count && app.count > 1 ? `${app.name} (${app.count})` : app.name;
     return {
-      value: app.bundleId ?? `${app.name}-${app.pid ?? 0}`,
-      label: app.name,
+      value,
+      label,
       ...hint ? { hint } : {}
     };
   });
-  const options = [
-    {
-      value: SELECT_ALL_VALUE,
-      label: "Quit all apps",
-      hint: `${apps.length} eligible apps`
-    },
-    ...appOptions
-  ];
-  const initialValues = [SELECT_ALL_VALUE];
-  const proto = MultiSelectPrompt?.prototype;
-  const origPrompt = proto?.prompt;
-  const origToggleValue = proto?.toggleValue;
-  const origToggleAll = proto?.toggleAll;
-  const origToggleInvert = proto?.toggleInvert;
-  let selected;
-  try {
-    if (proto && origPrompt) {
-      proto.prompt = function() {
-        if (this.options?.some((o) => o.value === SELECT_ALL_VALUE)) {
-          attachQuitAllBehavior(
-            this
-          );
-        }
-        return origPrompt.call(this);
-      };
-    }
-    selected = await multiselect({
-      message: "Select apps to quit",
-      options,
-      required: false,
-      initialValues
-    });
-  } finally {
-    if (proto && origPrompt) proto.prompt = origPrompt;
-    if (proto && origToggleValue) proto.toggleValue = origToggleValue;
-    if (proto && origToggleAll) proto.toggleAll = origToggleAll;
-    if (proto && origToggleInvert) {
-      proto.toggleInvert = origToggleInvert;
-    }
-  }
+  const defaultSelectAll = options.defaultSelectAll ?? true;
+  const initialValues = defaultSelectAll ? appOptions.map((opt) => opt.value) : [];
+  const selected = await multiselect({
+    message: "Select apps to quit",
+    options: appOptions,
+    required: false,
+    initialValues
+  });
   if (isCancel(selected) || !Array.isArray(selected)) {
     return selected;
   }
@@ -671,9 +849,10 @@ async function selectApps(apps) {
     return [...apps];
   }
   const selectedSet = new Set(selectedArray);
-  return apps.filter((app) => {
-    const key = app.bundleId ?? `${app.name}-${app.pid ?? 0}`;
-    return selectedSet.has(key);
+  return apps.filter((app, index) => {
+    const optValue = appOptions[index]?.value;
+    const key = app.bundleId ?? `${app.name}-${app.pid ?? index}`;
+    return optValue && selectedSet.has(optValue) || app.bundleId && selectedSet.has(app.bundleId) || selectedSet.has(key);
   });
 }
 async function shouldConfirmQuit(count, isAll = false, forceYes = false) {
@@ -699,11 +878,17 @@ async function allCommand(options = {}) {
   const config = loadConfig();
   const useForce = options.force ?? config.force === "force";
   const includeFinder = options.includeFinder ?? config.includeFinder;
+  const includeTrash = options.includeTrash ?? config.includeTrash;
   const includeBackground = options.includeBackground ?? config.includeBackground;
+  const neverQuitMusic = options.neverQuitMusic ?? config.neverQuitMusic;
   const apps = await getRunningApps({
     exclude: config.exclude,
     includeFinder,
-    includeBackground
+    includeTrash,
+    includeBackground,
+    groupBackground: config.groupBackground,
+    neverQuitMusic,
+    musicApps: options.musicApps ?? config.musicApps
   });
   if (apps.length === 0) {
     if (options.json) {
@@ -798,6 +983,37 @@ async function toggleIncludeFinder() {
     `Include Finder: ${config.includeFinder ? "enabled" : "disabled"}`
   );
 }
+async function toggleIncludeTrash() {
+  const config = loadConfig();
+  const choice = await select({
+    message: `Include Empty Trash in list (current: ${config.includeTrash ? "enabled" : "disabled"})`,
+    options: [
+      {
+        value: "disabled",
+        label: "Disabled",
+        hint: "Empty Trash is not shown in the app list."
+      },
+      {
+        value: "enabled",
+        label: "Enabled",
+        hint: "Shows 'Empty Trash' in list. Quitting it PERMANENTLY deletes all items in Trash (cannot be undone)."
+      },
+      backOption()
+    ],
+    initialValue: config.includeTrash ? "enabled" : "disabled"
+  });
+  if (isCancel(choice) || choice === BACK_VALUE) return;
+  config.includeTrash = choice === "enabled";
+  saveConfig(config);
+  log.success(
+    `Include Empty Trash in list: ${config.includeTrash ? "enabled" : "disabled"}`
+  );
+  if (config.includeTrash) {
+    log.warn(
+      "Note: Quitting 'Empty Trash' permanently and irreversibly deletes all files in macOS Trash."
+    );
+  }
+}
 async function toggleIncludeBackground() {
   const config = loadConfig();
   const choice = await select({
@@ -824,6 +1040,85 @@ async function toggleIncludeBackground() {
     `Background apps: ${config.includeBackground ? "enabled" : "disabled"}`
   );
 }
+async function toggleDefaultSelection() {
+  const config = loadConfig();
+  const currentVal = config.defaultSelectAll ? "select-all" : "deselect-all";
+  const choice = await select({
+    message: `Default App Selection (current: ${currentVal})`,
+    options: [
+      {
+        value: "select-all",
+        label: "Select all apps",
+        hint: "All apps are pre-selected by default when launching quitx."
+      },
+      {
+        value: "deselect-all",
+        label: "Deselect all apps",
+        hint: "No apps are selected by default. Pick specific apps to quit."
+      },
+      backOption()
+    ],
+    initialValue: currentVal
+  });
+  if (isCancel(choice) || choice === BACK_VALUE) return;
+  config.defaultSelectAll = choice === "select-all";
+  saveConfig(config);
+  log.success(
+    `Default selection: ${config.defaultSelectAll ? "select-all" : "deselect-all"}`
+  );
+}
+async function toggleGroupBackground() {
+  const config = loadConfig();
+  const choice = await select({
+    message: `Group Background Instances (current: ${config.groupBackground ? "enabled" : "disabled"})`,
+    options: [
+      {
+        value: "enabled",
+        label: "Enabled",
+        hint: "Combines multiple instances of the same background app into a single item with instance count."
+      },
+      {
+        value: "disabled",
+        label: "Disabled",
+        hint: "Lists each background instance separately with its process ID (PID)."
+      },
+      backOption()
+    ],
+    initialValue: config.groupBackground ? "enabled" : "disabled"
+  });
+  if (isCancel(choice) || choice === BACK_VALUE) return;
+  config.groupBackground = choice === "enabled";
+  saveConfig(config);
+  log.success(
+    `Group background instances: ${config.groupBackground ? "enabled" : "disabled"}`
+  );
+}
+async function toggleNeverQuitMusic() {
+  const config = loadConfig();
+  const choice = await select({
+    message: `Never Quit Music Apps (current: ${config.neverQuitMusic ? "enabled" : "disabled"})`,
+    options: [
+      {
+        value: "enabled",
+        label: "Enabled",
+        hint: "Never show or quit music players (Spotify, Apple Music, Tidal, etc.) to keep your audio playing."
+      },
+      {
+        value: "disabled",
+        label: "Disabled",
+        hint: "Include music apps in quit list normally."
+      },
+      backOption()
+    ],
+    initialValue: config.neverQuitMusic ? "enabled" : "disabled"
+  });
+  if (isCancel(choice) || choice === BACK_VALUE) return;
+  config.neverQuitMusic = choice === "enabled";
+  saveConfig(config);
+  log.success(
+    `Never quit music apps: ${config.neverQuitMusic ? "enabled" : "disabled"}`
+  );
+}
 async function manageExcludedApps() {
   const choice = await select({
     message: "Manage excluded apps",
@@ -848,13 +1143,12 @@ ${config.exclude.map((e) => `  - ${e}`).join("\n")}`
     return;
   }
   if (choice === "add") {
-    const apps = await getRunningApps();
-    const currentSet = new Set(
-      config.exclude.map((e) => e.toLowerCase().trim())
-    );
-    const available = apps.filter(
-      (a) => !currentSet.has(a.name.toLowerCase().trim()) && !(a.bundleId && currentSet.has(a.bundleId.toLowerCase().trim()))
-    );
+    const available = await getRunningApps({
+      exclude: config.exclude,
+      includeFinder: config.includeFinder,
+      includeBackground: config.includeBackground,
+      groupBackground: config.groupBackground
+    });
     if (available.length === 0) {
       log.info("All running apps are already excluded.");
       return;
@@ -899,8 +1193,88 @@ ${config.exclude.map((e) => `  - ${e}`).join("\n")}`
     log.success(`Removed ${selected.length} apps from exclude list.`);
   }
 }
+async function manageCustomMusicApps() {
+  const choice = await select({
+    message: "Manage custom music apps",
+    options: [
+      { value: "add", label: "Add running apps to custom music list" },
+      { value: "remove", label: "Remove apps from custom music list" },
+      { value: "view", label: "View current custom music list" },
+      backOption()
+    ]
+  });
+  if (isCancel(choice) || choice === BACK_VALUE) return;
+  const config = loadConfig();
+  if (choice === "view") {
+    if (config.musicApps.length === 0) {
+      log.info("No custom music apps registered.");
+    } else {
+      log.info(
+        `Custom music apps:
+${config.musicApps.map((e) => `  - ${e}`).join("\n")}`
+      );
+    }
+    return;
+  }
+  if (choice === "add") {
+    const available = await getRunningApps({
+      exclude: config.exclude,
+      includeFinder: config.includeFinder,
+      includeBackground: config.includeBackground,
+      groupBackground: config.groupBackground,
+      neverQuitMusic: false
+    });
+    const unadded = available.filter(
+      (a) => !config.musicApps.some(
+        (m) => m.toLowerCase() === a.name.toLowerCase() || a.bundleId && m.toLowerCase() === a.bundleId.toLowerCase()
+      )
+    );
+    if (unadded.length === 0) {
+      log.info("All running apps are already in custom music list.");
+      return;
+    }
+    const selected = await multiselect({
+      message: "Select apps to mark as music players",
+      options: unadded.map((a) => ({
+        value: a.name,
+        label: a.name,
+        ...a.bundleId ? { hint: a.bundleId } : {}
+      })),
+      required: false
+    });
+    if (isCancel(selected)) return;
+    if (!Array.isArray(selected) || selected.length === 0) {
+      log.info("No apps selected.");
+      return;
+    }
+    addMusicApps(selected);
+    log.success(`Added ${selected.length} apps to custom music list.`);
+    return;
+  }
+  if (choice === "remove") {
+    if (config.musicApps.length === 0) {
+      log.info("No apps currently in custom music list.");
+      return;
+    }
+    const selected = await multiselect({
+      message: "Select apps to remove from custom music list",
+      options: config.musicApps.map((name) => ({
+        value: name,
+        label: name
+      })),
+      required: false
+    });
+    if (isCancel(selected)) return;
+    if (!Array.isArray(selected) || selected.length === 0) {
+      log.info("No apps selected.");
+      return;
+    }
+    removeMusicApps(selected);
+    log.success(`Removed ${selected.length} apps from custom music list.`);
+  }
+}
 function resetConfig() {
-  saveConfig({ ...DEFAULT_CONFIG, exclude: [] });
+  saveConfig({ ...DEFAULT_CONFIG, exclude: [], musicApps: [] });
   log.success("Config reset to defaults.");
 }
 async function configCommand() {
@@ -913,28 +1287,53 @@ async function configCommand() {
       options: [
         {
           value: "quit-mode",
-          label: `Toggle Quit Mode`,
-          hint: `current: ${config.force}`
+          label: "Quit Mode",
+          hint: `current: ${config.force === "normal" ? "Normal quit" : "Force quit"}`
+        },
+        {
+          value: "background",
+          label: "View background apps",
+          hint: `current: ${config.includeBackground ? "enabled" : "disabled"}`
+        },
+        {
+          value: "group-background",
+          label: "Group background instances",
+          hint: `current: ${config.groupBackground ? "enabled" : "disabled"}`
+        },
+        {
+          value: "never-quit-music",
+          label: "Never quit music apps",
+          hint: `current: ${config.neverQuitMusic ? "enabled" : "disabled"}`
+        },
+        {
+          value: "default-select",
+          label: "Deselect apps by default",
+          hint: `current: ${!config.defaultSelectAll ? "enabled" : "disabled"}`
         },
         {
           value: "finder",
-          label: `Toggle Include Finder`,
+          label: "Include Finder Windows in list",
           hint: `current: ${config.includeFinder ? "enabled" : "disabled"}`
         },
         {
-          value: "background",
-          label: `Toggle Background Apps`,
-          hint: `current: ${config.includeBackground ? "enabled" : "disabled"}`
+          value: "trash",
+          label: "Include Empty Trash in list",
+          hint: `current: ${config.includeTrash ? "enabled (empties trash)" : "disabled"}`
         },
         {
           value: "exclude",
-          label: "Manage Excluded Apps",
+          label: "Manage excluded apps",
           hint: `${config.exclude.length} excluded`
         },
+        {
+          value: "custom-music",
+          label: "Manage custom music apps",
+          hint: `${config.musicApps.length} custom apps`
+        },
         {
           value: "reset",
-          label: "Reset to Defaults",
-          hint: "restore all settings"
+          label: "Reset all",
+          hint: "restore all settings to defaults"
         },
         { value: "exit", label: "Exit" }
       ]
@@ -944,9 +1343,14 @@ async function configCommand() {
       continue;
     }
     if (choice === "quit-mode") await toggleQuitMode();
-    if (choice === "finder") await toggleIncludeFinder();
     if (choice === "background") await toggleIncludeBackground();
+    if (choice === "group-background") await toggleGroupBackground();
+    if (choice === "never-quit-music") await toggleNeverQuitMusic();
+    if (choice === "default-select") await toggleDefaultSelection();
+    if (choice === "finder") await toggleIncludeFinder();
+    if (choice === "trash") await toggleIncludeTrash();
     if (choice === "exclude") await manageExcludedApps();
+    if (choice === "custom-music") await manageCustomMusicApps();
     if (choice === "reset") resetConfig();
   }
   showOutro("Config saved.");
@@ -982,13 +1386,12 @@ ${currentConfig.exclude.map((e) => `  - ${e}`).join("\n")}`
     return 0;
   }
   if (choice === "add") {
-    const apps = await getRunningApps();
-    const currentSet = new Set(
-      currentConfig.exclude.map((e) => e.toLowerCase().trim())
-    );
-    const available = apps.filter(
-      (a) => !currentSet.has(a.name.toLowerCase().trim()) && !(a.bundleId && currentSet.has(a.bundleId.toLowerCase().trim()))
-    );
+    const available = await getRunningApps({
+      exclude: currentConfig.exclude,
+      includeFinder: currentConfig.includeFinder,
+      includeBackground: currentConfig.includeBackground,
+      groupBackground: currentConfig.groupBackground
+    });
     if (available.length === 0) {
       showOutro("All running apps are already excluded.");
       printThanks();
@@ -1077,11 +1480,17 @@ async function interactiveCommand(options = {}) {
   const config = loadConfig();
   const useForce = options.force ?? config.force === "force";
   const includeFinder = options.includeFinder ?? config.includeFinder;
+  const includeTrash = options.includeTrash ?? config.includeTrash;
   const includeBackground = options.includeBackground ?? config.includeBackground;
+  const neverQuitMusic = options.neverQuitMusic ?? config.neverQuitMusic;
   const apps = await getRunningApps({
     exclude: config.exclude,
     includeFinder,
-    includeBackground
+    includeTrash,
+    includeBackground,
+    groupBackground: config.groupBackground,
+    neverQuitMusic,
+    musicApps: options.musicApps ?? config.musicApps
   });
   if (!options.json) {
     s.stop(
@@ -1120,7 +1529,9 @@ async function interactiveCommand(options = {}) {
       return 0;
     }
   } else {
-    const selected = await selectApps(apps);
+    const selected = await selectApps(apps, {
+      defaultSelectAll: config.defaultSelectAll
+    });
     if (typeof selected === "symbol" || isCancel(selected)) {
       showCancel("Cancelled.");
       printThanks(options);
@@ -1134,11 +1545,7 @@ async function interactiveCommand(options = {}) {
     targetApps = selected;
   }
   if (!options.yes) {
-    const confirmation = await shouldConfirmQuit(
-      targetApps.length,
-      targetApps.length === apps.length,
-      false
-    );
+    const confirmation = await shouldConfirmQuit(targetApps.length, false);
     if (isCancel(confirmation) || confirmation !== true) {
       showCancel("Cancelled.");
       printThanks(options);
@@ -1177,11 +1584,17 @@ async function interactiveCommand(options = {}) {
 async function listCommand(options = {}) {
   const config = loadConfig();
   const includeFinder = options.includeFinder ?? config.includeFinder;
+  const includeTrash = options.includeTrash ?? config.includeTrash;
   const includeBackground = options.includeBackground ?? config.includeBackground;
+  const neverQuitMusic = options.neverQuitMusic ?? config.neverQuitMusic;
   const apps = await getRunningApps({
     exclude: config.exclude,
     includeFinder,
-    includeBackground
+    includeTrash,
+    includeBackground,
+    groupBackground: config.groupBackground,
+    neverQuitMusic,
+    musicApps: options.musicApps ?? config.musicApps
   });
   renderList(apps, options.json);
   return 0;
@@ -1243,8 +1656,12 @@ function parseCliArgs(args) {
       options.json = true;
     } else if (arg === "--include-finder") {
       options.includeFinder = true;
+    } else if (arg === "--include-trash") {
+      options.includeTrash = true;
     } else if (arg === "-b" || arg === "--background") {
       options.includeBackground = true;
+    } else if (arg === "--never-quit-music") {
+      options.neverQuitMusic = true;
     } else if (arg === "--config") {
       options.manageConfig = true;
     } else if (arg === "--exclude") {
@@ -1300,7 +1717,9 @@ function parseCliArgs(args) {
 }
 async function main(argv = process.argv.slice(2)) {
   if (!isMacOS()) {
-    console.error("\u2716 quitx only works on macOS.");
+    console.error(
+      "\u2716 quitx only works on macOS. Windows and Linux are not supported."
+    );
     return 1;
   }
   ensureMacOS();
@@ -1352,7 +1771,9 @@ async function main(argv = process.argv.slice(2)) {
     return 1;
   }
 }
-if (process.argv[1] && (process.argv[1].endsWith("/cli.ts") || process.argv[1].endsWith("/cli.js") || process.argv[1].endsWith("/quitx"))) {
+var scriptName = process.argv[1] ? process.argv[1].replace(/\\/g, "/").split("/").pop()?.toLowerCase() : "";
+var isMain = scriptName === "cli.ts" || scriptName === "cli.js" || scriptName === "quitx" || scriptName === "quitx.cmd" || scriptName === "quitx.ps1" || scriptName === "quitx.exe";
+if (isMain) {
   main().then((code) => {
     if (code !== 0) {
       process.exit(code);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreify/quitx",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A macOS CLI for viewing running GUI applications and quitting them properly.",
   "type": "module",
   "bin": {