@coreify/quitx 1.0.0 → 1.2.0

package/dist/cli.js

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
-import { readFile } from 'fs/promises';
-import { select, isCancel, spinner, log, intro, multiselect, outro, confirm, cancel } from '@clack/prompts';
+import { spinner, select, isCancel, log, intro, outro, multiselect, confirm, cancel } from '@clack/prompts';
+import { readFile, mkdir, writeFile } from 'fs/promises';
 import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
 import { homedir } from 'os';
-import { join } from 'path';
+import { join, dirname } 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,43 @@ var DEFAULT_CONFIG = {
   exclude: [],
   force: "normal",
   includeFinder: false,
-  includeBackground: false
+  includeTrash: false,
+  includeBackground: false,
+  groupBackground: true,
+  defaultSelectAll: true,
+  neverQuitMusic: false,
+  musicApps: [],
+  autoUpdate: true
 };
 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;
+    const autoUpdateVal = typeof obj.autoUpdate === "boolean" ? obj.autoUpdate : typeof obj.checkUpdate === "boolean" ? obj.checkUpdate : DEFAULT_CONFIG.autoUpdate;
     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,
+      autoUpdate: autoUpdateVal
     };
   } catch {
-    return { ...DEFAULT_CONFIG, exclude: [] };
+    return { ...DEFAULT_CONFIG, exclude: [], musicApps: [] };
   }
 }
 function saveConfig(config, filePath = CONFIG_FILE) {
@@ -72,6 +87,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 +138,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 +158,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 +203,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 +312,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);
+  }
+  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(filtered);
+  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 +387,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 +428,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 +552,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 +586,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 +598,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,10 +650,18 @@ function forceQuitApp(app) {
   }
   return false;
 }
+var DEFAULT_QUIT_TIMEOUT_MS = 8e3;
 async function quitApps(apps, options = {}, executor, deferredScheduler = defaultDeferredQuitScheduler) {
   if (apps.length === 0) {
     return [];
   }
+  if (options.dryRun) {
+    return apps.map((app) => ({
+      app,
+      success: true,
+      forced: options.force ?? false
+    }));
+  }
   const currentTerminalApps = [];
   const otherApps = [];
   for (const app of apps) {
@@ -413,21 +673,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 });
@@ -469,14 +741,15 @@ function showOutro(message) {
 function showCancel(message = "Cancelled.") {
   cancel(message);
 }
-function renderResults(results) {
+function renderResults(results, dryRun = false) {
   for (const res of results) {
     if (res.success) {
-      const label = res.forced ? `Force quit ${res.app.name}` : res.app.name;
+      const label = dryRun ? res.forced ? `[dry-run] Would force quit ${res.app.name}` : `[dry-run] Would quit ${res.app.name}` : res.forced ? `Force quit ${res.app.name}` : res.app.name;
       log.success(label);
     } else {
+      const prefix = dryRun ? "[dry-run] " : "";
       const reason = res.error ? ` (${res.error})` : "";
-      log.error(`Could not quit ${res.app.name}${reason}`);
+      log.error(`${prefix}Could not quit ${res.app.name}${reason}`);
     }
   }
 }
@@ -502,27 +775,37 @@ OPTIONS:
   -y, --yes               Skip confirmation prompts
   -l, --list              List running GUI apps and exit
   -f, --force             Force quit apps (SIGKILL) if normal quit fails
+      --dry-run           Simulate quitting without terminating apps
   -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)
+      --check-update      Check for package updates (60s rate limit)
+      --no-update-check   Disable automatic update check for this run
       --config            Open interactive config manager
       --json              Output data in JSON format
   -h, --help              Show help information
   -v, --version           Show version number
 
 COMMANDS:
-  config                  Manage configuration interactively
+  config [action]         Manage configuration (show, get, set, reset)
   exclude                 Manage excluded applications interactively
+  check-update            Check for package updates
 
 EXAMPLES:
   $ quitx                         Interactive app selector
   $ quitx --all                   Quit all running apps (with confirmation)
+  $ quitx --all --dry-run         Preview quitting all apps without killing them
   $ quitx --all --yes             Quit all running apps immediately
   $ quitx --list                  List currently running GUI apps
   $ quitx --list --background     List all apps including background processes
   $ quitx --list --include-finder List apps including Finder
   $ quitx config                  Open interactive config manager
+  $ quitx config show             Print current configuration
+  $ quitx config set force true   Set default quit mode to force
+  $ quitx config get exclude      Print excluded apps list
   $ quitx exclude                 Open interactive menu to manage excluded apps
+  $ quitx check-update            Check for package updates
   $ quitx --exclude Spotify,Slack Add Spotify and Slack to exclude list
   $ quitx Slack,Discord           Quit specific apps directly
 `.trim()
@@ -531,7 +814,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 +824,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 +869,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 +898,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) {
@@ -724,14 +929,20 @@ async function allCommand(options = {}) {
   }
   const s = spinner();
   if (!options.json) {
-    s.start(`Quitting ${apps.length} apps...`);
+    s.start(
+      options.dryRun ? `Simulating quit for ${apps.length} apps...` : `Quitting ${apps.length} apps...`
+    );
   }
-  const results = await quitApps(apps, { force: useForce });
+  const results = await quitApps(apps, {
+    force: useForce,
+    dryRun: options.dryRun
+  });
   if (!options.json) {
-    s.stop("Quitting complete");
-    renderResults(results);
+    s.stop(options.dryRun ? "Dry run complete" : "Quitting complete");
+    renderResults(results, options.dryRun);
     const successCount = results.filter((r) => r.success).length;
-    showOutro(`Quit ${successCount} of ${apps.length} apps.`);
+    const actionVerb = options.dryRun ? "Would quit" : "Quit";
+    showOutro(`${actionVerb} ${successCount} of ${apps.length} apps.`);
     printThanks(options);
   } else {
     console.log(
@@ -798,6 +1009,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 +1066,111 @@ 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 toggleAutoUpdate() {
+  const config = loadConfig();
+  const choice = await select({
+    message: `Automatic Update Checks (current: ${config.autoUpdate ? "enabled" : "disabled"})`,
+    options: [
+      {
+        value: "enabled",
+        label: "Enabled",
+        hint: "Check npm registry in background every 6 hours for updates."
+      },
+      {
+        value: "disabled",
+        label: "Disabled",
+        hint: "Never perform automatic background update checks."
+      },
+      backOption()
+    ],
+    initialValue: config.autoUpdate ? "enabled" : "disabled"
+  });
+  if (isCancel(choice) || choice === BACK_VALUE) return;
+  config.autoUpdate = choice === "enabled";
+  saveConfig(config);
+  log.success(
+    `Automatic update checks: ${config.autoUpdate ? "enabled" : "disabled"}`
+  );
+}
 async function manageExcludedApps() {
   const choice = await select({
     message: "Manage excluded apps",
@@ -848,13 +1195,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 +1245,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 +1339,58 @@ 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: "auto-update",
+          label: "Automatic update checks",
+          hint: `current: ${config.autoUpdate ? "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,15 +1400,155 @@ 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 === "auto-update") await toggleAutoUpdate();
+    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.");
   printThanks();
   return 0;
 }
+var VALID_CONFIG_KEYS = [
+  "exclude",
+  "force",
+  "includeFinder",
+  "includeTrash",
+  "includeBackground",
+  "groupBackground",
+  "defaultSelectAll",
+  "neverQuitMusic",
+  "musicApps",
+  "autoUpdate"
+];
+async function handleConfigCli(options = {}) {
+  const action = options.configAction;
+  if (!action) {
+    return await configCommand();
+  }
+  const config = loadConfig();
+  if (action === "show") {
+    if (options.json) {
+      console.log(JSON.stringify(config, null, 2));
+      return 0;
+    }
+    console.log("quitx configuration:");
+    for (const [key, value] of Object.entries(config)) {
+      const displayVal = Array.isArray(value) ? value.length === 0 ? "[]" : `[${value.join(", ")}]` : String(value);
+      console.log(`  ${key}: ${displayVal}`);
+    }
+    return 0;
+  }
+  if (action === "get") {
+    if (!options.configKey) {
+      console.error("\u2716 Missing config key. Usage: quitx config get <key>");
+      return 1;
+    }
+    const key = options.configKey;
+    if (!VALID_CONFIG_KEYS.includes(key)) {
+      console.error(
+        `\u2716 Unknown config key: "${options.configKey}". Valid keys: ${VALID_CONFIG_KEYS.join(", ")}`
+      );
+      return 1;
+    }
+    const val = config[key];
+    if (options.json) {
+      console.log(JSON.stringify({ [key]: val }, null, 2));
+    } else if (Array.isArray(val)) {
+      console.log(val.join(", "));
+    } else {
+      console.log(String(val));
+    }
+    return 0;
+  }
+  if (action === "set") {
+    if (!options.configKey) {
+      console.error(
+        "\u2716 Missing config key. Usage: quitx config set <key> <value>"
+      );
+      return 1;
+    }
+    if (options.configValue === void 0) {
+      console.error(
+        `\u2716 Missing value for "${options.configKey}". Usage: quitx config set <key> <value>`
+      );
+      return 1;
+    }
+    const key = options.configKey;
+    if (!VALID_CONFIG_KEYS.includes(key)) {
+      console.error(
+        `\u2716 Unknown config key: "${options.configKey}". Valid keys: ${VALID_CONFIG_KEYS.join(", ")}`
+      );
+      return 1;
+    }
+    const raw = options.configValue.trim();
+    if (key === "force") {
+      const lower = raw.toLowerCase();
+      if (lower === "force" || lower === "true" || lower === "1") {
+        config.force = "force";
+      } else if (lower === "normal" || lower === "false" || lower === "0") {
+        config.force = "normal";
+      } else {
+        console.error(
+          `\u2716 Invalid value for force: "${raw}". Must be "normal" or "force".`
+        );
+        return 1;
+      }
+    } else if (key === "includeFinder" || key === "includeTrash" || key === "includeBackground" || key === "groupBackground" || key === "defaultSelectAll" || key === "neverQuitMusic" || key === "autoUpdate") {
+      const lower = raw.toLowerCase();
+      if (["true", "1", "yes", "on", "enable", "enabled"].includes(lower)) {
+        config[key] = true;
+      } else if (["false", "0", "no", "off", "disable", "disabled"].includes(lower)) {
+        config[key] = false;
+      } else {
+        console.error(
+          `\u2716 Invalid boolean for ${key}: "${raw}". Use true or false.`
+        );
+        return 1;
+      }
+    } else if (key === "exclude" || key === "musicApps") {
+      const items = raw.split(",").map((s) => s.trim()).filter(Boolean);
+      config[key] = items;
+    }
+    saveConfig(config);
+    if (options.json) {
+      console.log(JSON.stringify({ [key]: config[key] }, null, 2));
+    } else {
+      const displayVal = Array.isArray(config[key]) ? `[${config[key].join(", ")}]` : String(config[key]);
+      console.log(`Set ${key} = ${displayVal}`);
+    }
+    return 0;
+  }
+  if (action === "reset") {
+    if (!options.yes) {
+      const confirm2 = await select({
+        message: "Reset all settings to defaults?",
+        options: [
+          { value: "yes", label: "Yes, reset all" },
+          { value: "no", label: "No, keep current settings" }
+        ],
+        initialValue: "no"
+      });
+      if (isCancel(confirm2) || confirm2 !== "yes") {
+        return 0;
+      }
+    }
+    saveConfig({ ...DEFAULT_CONFIG, exclude: [], musicApps: [] });
+    if (options.json) {
+      console.log(JSON.stringify({ reset: true }, null, 2));
+    } else {
+      log.success("Config reset to defaults.");
+    }
+    return 0;
+  }
+  return 0;
+}
 async function manageExcludeInteractive() {
   showIntro();
   const choice = await select({
@@ -982,13 +1578,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 +1672,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 +1721,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 +1737,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);
@@ -1147,15 +1746,21 @@ async function interactiveCommand(options = {}) {
   }
   if (!options.json) {
     s.start(
-      `Quitting ${targetApps.length} ${targetApps.length === 1 ? "app" : "apps"}...`
+      options.dryRun ? `Simulating quit for ${targetApps.length} ${targetApps.length === 1 ? "app" : "apps"}...` : `Quitting ${targetApps.length} ${targetApps.length === 1 ? "app" : "apps"}...`
     );
   }
-  const results = await quitApps(targetApps, { force: useForce });
+  const results = await quitApps(targetApps, {
+    force: useForce,
+    dryRun: options.dryRun
+  });
   if (!options.json) {
-    s.stop("Quitting complete");
-    renderResults(results);
+    s.stop(options.dryRun ? "Dry run complete" : "Quitting complete");
+    renderResults(results, options.dryRun);
     const successCount = results.filter((r) => r.success).length;
-    showOutro(`Done. Quit ${successCount} of ${targetApps.length} apps.`);
+    const actionVerb = options.dryRun ? "Would quit" : "Quit";
+    showOutro(
+      `Done. ${actionVerb} ${successCount} of ${targetApps.length} apps.`
+    );
     printThanks(options);
   } else {
     console.log(
@@ -1177,15 +1782,214 @@ 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;
 }
+var CHECK_INTERVAL_MS = 6 * 60 * 60 * 1e3;
+var MANUAL_RATE_LIMIT_MS = 60 * 1e3;
+var REQUEST_TIMEOUT_MS = 1500;
+var REGISTRY_URL = "https://registry.npmjs.org/@coreify%2Fquitx/latest";
+var FALLBACK_REGISTRY_URL = "https://registry.npmjs.org/quitx/latest";
+var RELEASE_URL = "https://github.com/coreify/quitx/releases/latest";
+function updateCacheDirectory() {
+  const configured = process.env.XDG_CACHE_HOME;
+  if (configured) return join(configured, "quitx");
+  return join(homedir(), ".quitx");
+}
+function parseVersion(version) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([\dA-Za-z.-]+))?(?:\+[\dA-Za-z.-]+)?$/u.exec(
+    version.trim()
+  );
+  if (!match) return void 0;
+  const numbers = [
+    Number(match[1]),
+    Number(match[2]),
+    Number(match[3])
+  ];
+  return match[4] ? { numbers, prerelease: match[4].split(".") } : { numbers };
+}
+function compareVersions(left, right) {
+  const leftVersion = parseVersion(left);
+  const rightVersion = parseVersion(right);
+  if (!leftVersion || !rightVersion) return 0;
+  for (let index = 0; index < 3; index++) {
+    const difference = leftVersion.numbers[index] - rightVersion.numbers[index];
+    if (difference !== 0) return Math.sign(difference);
+  }
+  if (!leftVersion.prerelease && !rightVersion.prerelease) return 0;
+  if (!leftVersion.prerelease) return 1;
+  if (!rightVersion.prerelease) return -1;
+  const length = Math.max(
+    leftVersion.prerelease.length,
+    rightVersion.prerelease.length
+  );
+  for (let index = 0; index < length; index++) {
+    const leftPart = leftVersion.prerelease[index];
+    const rightPart = rightVersion.prerelease[index];
+    if (leftPart === void 0) return -1;
+    if (rightPart === void 0) return 1;
+    if (leftPart === rightPart) continue;
+    const leftNumber = /^\d+$/u.test(leftPart) ? Number(leftPart) : void 0;
+    const rightNumber = /^\d+$/u.test(rightPart) ? Number(rightPart) : void 0;
+    if (leftNumber !== void 0 && rightNumber !== void 0) {
+      return Math.sign(leftNumber - rightNumber);
+    }
+    if (leftNumber !== void 0) return -1;
+    if (rightNumber !== void 0) return 1;
+    return leftPart.localeCompare(rightPart);
+  }
+  return 0;
+}
+async function readCache(path) {
+  try {
+    const value = JSON.parse(await readFile(path, "utf8"));
+    if (typeof value !== "object" || value === null) return {};
+    const record = value;
+    return {
+      ...typeof record.checkedAt === "number" && Number.isFinite(record.checkedAt) ? { checkedAt: record.checkedAt } : {},
+      ...typeof record.ignoredVersion === "string" && parseVersion(record.ignoredVersion) ? { ignoredVersion: record.ignoredVersion } : {},
+      ...typeof record.latestVersion === "string" && parseVersion(record.latestVersion) ? { latestVersion: record.latestVersion } : {}
+    };
+  } catch {
+    return {};
+  }
+}
+async function writeCache(path, value) {
+  try {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(value), { mode: 384 });
+  } catch {
+  }
+}
+async function fetchLatestVersion(fetcher = fetch) {
+  const urls = [REGISTRY_URL, FALLBACK_REGISTRY_URL];
+  for (const url of urls) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    timer.unref();
+    try {
+      const response = await fetcher(url, {
+        headers: { accept: "application/json" },
+        signal: controller.signal
+      });
+      if (!response.ok) continue;
+      const value = await response.json();
+      if (typeof value === "object" && value !== null && "version" in value && typeof value.version === "string" && parseVersion(value.version)) {
+        return value.version;
+      }
+    } catch {
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  throw new Error("Unable to fetch latest version from npm registry");
+}
+async function checkForUpdate(currentVersion, options = {}) {
+  if (!parseVersion(currentVersion)) return void 0;
+  const now = options.now ?? Date.now();
+  const cachePath = join(
+    options.cacheDirectory ?? updateCacheDirectory(),
+    "update.json"
+  );
+  const cache = await readCache(cachePath);
+  let latestVersion = cache.latestVersion;
+  if (options.force || !cache.checkedAt || now - cache.checkedAt >= CHECK_INTERVAL_MS) {
+    try {
+      latestVersion = await fetchLatestVersion(options.fetcher ?? fetch);
+      await writeCache(cachePath, {
+        ...cache,
+        checkedAt: now,
+        latestVersion
+      });
+    } catch {
+    }
+  }
+  if (!latestVersion || latestVersion === cache.ignoredVersion || compareVersions(latestVersion, currentVersion) <= 0) {
+    return void 0;
+  }
+  return {
+    currentVersion,
+    latestVersion,
+    releaseUrl: RELEASE_URL
+  };
+}
+async function checkUpdateManually(currentVersion, options = {}) {
+  const now = options.now ?? Date.now();
+  const cachePath = join(
+    options.cacheDirectory ?? updateCacheDirectory(),
+    "update.json"
+  );
+  const cache = await readCache(cachePath);
+  let latestVersion = cache.latestVersion;
+  const isRateLimited = Boolean(
+    !options.force && cache.checkedAt && now - cache.checkedAt < MANUAL_RATE_LIMIT_MS
+  );
+  if (!isRateLimited) {
+    try {
+      latestVersion = await fetchLatestVersion(options.fetcher ?? fetch);
+      await writeCache(cachePath, {
+        ...cache,
+        checkedAt: now,
+        latestVersion
+      });
+    } catch {
+    }
+  }
+  const effectiveLatest = latestVersion ?? currentVersion;
+  const updateAvailable = Boolean(
+    latestVersion && compareVersions(latestVersion, currentVersion) > 0
+  );
+  return {
+    currentVersion,
+    latestVersion: effectiveLatest,
+    rateLimited: isRateLimited,
+    releaseUrl: RELEASE_URL,
+    updateAvailable
+  };
+}
+async function ignoreUpdateVersion(version, cacheDir = updateCacheDirectory()) {
+  const cachePath = join(cacheDir, "update.json");
+  const cache = await readCache(cachePath);
+  await writeCache(cachePath, { ...cache, ignoredVersion: version });
+}
+function installUpdate(version, spawner = spawn) {
+  if (!parseVersion(version)) {
+    return Promise.reject(new Error(`Invalid update version: ${version}`));
+  }
+  return new Promise((resolve, reject) => {
+    const pkg = `@coreify/quitx@${version}`;
+    const child = spawner("npm", ["install", "--global", pkg], {
+      stdio: "inherit",
+      windowsHide: true
+    });
+    child.once("error", reject);
+    child.once("exit", (code, signal) => {
+      if (code === 0) resolve();
+      else {
+        reject(
+          new Error(
+            signal ? `Update stopped by ${signal}` : `npm install exited with code ${code ?? "unknown"}`
+          )
+        );
+      }
+    });
+  });
+}
+function updateNotice(update) {
+  return `Update available: ${update.currentVersion} \u2192 ${update.latestVersion}. Run: npm install --global @coreify/quitx@latest`;
+}
 
 // src/utils/platform.ts
 function isMacOS(platform = process.platform) {
@@ -1223,10 +2027,42 @@ function parseCliArgs(args) {
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (!arg) continue;
-    if (arg === "config") {
+    if (arg === "--dry-run") {
+      options.dryRun = true;
+    } else if (arg === "config") {
       options.manageConfig = true;
+      const next = args[i + 1];
+      if (next && !next.startsWith("-") && ["show", "get", "set", "reset"].includes(next.toLowerCase())) {
+        options.configAction = next.toLowerCase();
+        i++;
+        if (options.configAction === "get") {
+          const key = args[++i];
+          if (key && !key.startsWith("-")) {
+            options.configKey = key;
+          } else if (key) {
+            i--;
+          }
+        } else if (options.configAction === "set") {
+          const key = args[++i];
+          if (key && !key.startsWith("-")) {
+            options.configKey = key;
+            const val = args[++i];
+            if (val && !val.startsWith("-")) {
+              options.configValue = val;
+            } else if (val) {
+              i--;
+            }
+          } else if (key) {
+            i--;
+          }
+        }
+      }
     } else if (arg === "exclude") {
       options.manageExclude = true;
+    } else if (arg === "check-update" || arg === "--check-update") {
+      options.checkUpdate = true;
+    } else if (arg === "--no-update-check") {
+      options.noUpdateCheck = true;
     } else if (arg === "-a" || arg === "--all") {
       options.all = true;
     } else if (arg === "-y" || arg === "--yes") {
@@ -1243,8 +2079,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") {
@@ -1266,7 +2106,13 @@ function parseCliArgs(args) {
     }
   }
   if (rawPositional.length > 0) {
-    if (options.manageExclude) {
+    if (options.manageConfig) {
+      if (!options.configAction) {
+        throw new Error(
+          `Unknown config command: "${rawPositional[0]}". Usage: quitx config [show|get|set|reset]`
+        );
+      }
+    } else if (options.manageExclude) {
       if (rawPositional.length > 1 && !rawPositional.some((a) => a.includes(","))) {
         throw new Error(
           "Multiple exclude applications must be comma-separated, not space-separated. Example: quitx exclude Spotify,Discord"
@@ -1298,9 +2144,135 @@ function parseCliArgs(args) {
   }
   return options;
 }
+async function handleManualUpdateCheck(version, options) {
+  const isInteractive = !options.json && Boolean(process.stdout.isTTY && process.stdin.isTTY);
+  if (options.json) {
+    const result2 = await checkUpdateManually(version, { force: options.force });
+    console.log(JSON.stringify(result2, null, 2));
+    return 0;
+  }
+  if (isInteractive) {
+    showIntro();
+    const checkSpinner = spinner();
+    checkSpinner.start("Checking npm registry for updates");
+    const result2 = await checkUpdateManually(version, { force: options.force });
+    if (result2.rateLimited) {
+      checkSpinner.stop(
+        `Checked recently (rate limited, 60s cooldown). Latest: v${result2.latestVersion}`
+      );
+    } else if (result2.updateAvailable) {
+      checkSpinner.stop(
+        `Update available: ${result2.currentVersion} \u2192 ${result2.latestVersion}`
+      );
+    } else {
+      checkSpinner.stop(`quitx is up to date (v${result2.currentVersion})`);
+    }
+    if (result2.updateAvailable) {
+      console.log(
+        "\n  Upgrade Available: Run npm install --global @coreify/quitx@latest\n"
+      );
+      const answer = await select({
+        message: `Install v${result2.latestVersion} now?`,
+        options: [
+          { value: "install", label: "Install update now" },
+          { value: "skip", label: "Skip for now" }
+        ],
+        initialValue: "install"
+      });
+      if (isCancel(answer) || answer === "skip") {
+        printThanks(options);
+        return 0;
+      }
+      if (answer === "install") {
+        console.log(`Updating to ${result2.latestVersion}...`);
+        try {
+          await installUpdate(result2.latestVersion);
+          showOutro(
+            `Updated to ${result2.latestVersion}. Restart quitx to use it.`
+          );
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          console.error(`Failed to install update: ${msg}`);
+        }
+      }
+    }
+    printThanks(options);
+    return 0;
+  }
+  const result = await checkUpdateManually(version, { force: options.force });
+  if (result.updateAvailable) {
+    console.log(
+      `Update available: ${result.currentVersion} \u2192 ${result.latestVersion}`
+    );
+    console.log("Run: npm install --global @coreify/quitx@latest");
+  } else {
+    console.log(`quitx is up to date (${result.currentVersion})`);
+  }
+  if (result.rateLimited) {
+    console.log(
+      "(Checked recently with 60s rate limit; use --force to bypass)"
+    );
+  }
+  printThanks(options);
+  return 0;
+}
+async function handleAutoUpdateCheck(currentVersion, options) {
+  if (options.noUpdateCheck || options.checkUpdate || options.help || options.version || options.dryRun) {
+    return;
+  }
+  const config = loadConfig();
+  if (config.autoUpdate === false) {
+    return;
+  }
+  try {
+    const update = await checkForUpdate(currentVersion);
+    if (!update) return;
+    if (options.json || options.yes || !process.stdin.isTTY || !process.stdout.isTTY) {
+      console.error(updateNotice(update));
+      return;
+    }
+    console.log(
+      `
+Update available \xB7 ${update.currentVersion} \u2192 ${update.latestVersion}
+Release notes: ${update.releaseUrl}`
+    );
+    const action = await select({
+      message: "Update quitx?",
+      options: [
+        { value: "update", label: "Update now", hint: "npm install --global" },
+        { value: "skip", label: "Skip" },
+        {
+          value: "ignore",
+          label: "Skip this version",
+          hint: `hide ${update.latestVersion}`
+        }
+      ],
+      initialValue: "update"
+    });
+    if (isCancel(action) || action === "skip") {
+      return;
+    }
+    if (action === "ignore") {
+      await ignoreUpdateVersion(update.latestVersion);
+      return;
+    }
+    console.log(`Updating to ${update.latestVersion}...`);
+    try {
+      await installUpdate(update.latestVersion);
+      showOutro(`Updated to ${update.latestVersion}. Restart quitx to use it.`);
+      process.exit(0);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`Failed to install update: ${msg}`);
+    }
+  } catch {
+  }
+}
 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();
@@ -1323,15 +2295,21 @@ async function main(argv = process.argv.slice(2)) {
     printThanks(options);
     return 0;
   }
+  const version = await getPackageVersion();
   if (options.version) {
-    const version = await getPackageVersion();
     renderVersion(version);
     printThanks(options);
     return 0;
   }
+  if (options.checkUpdate) {
+    return await handleManualUpdateCheck(version, options);
+  }
+  if (!options.noUpdateCheck && !options.json) {
+    await handleAutoUpdateCheck(version, options);
+  }
   try {
     if (options.manageConfig) {
-      return await configCommand();
+      return await handleConfigCli(options);
     }
     if (options.manageExclude || options.exclude && options.exclude.length > 0) {
       return await excludeCommand(options);
@@ -1352,7 +2330,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);
@@ -1363,4 +2343,4 @@ if (process.argv[1] && (process.argv[1].endsWith("/cli.ts") || process.argv[1].e
   });
 }
 
-export { getPackageVersion, main, parseCliArgs };
+export { getPackageVersion, handleAutoUpdateCheck, handleManualUpdateCheck, main, parseCliArgs };