@event4u/agent-switch 2.1.0 → 2.3.0

package/dist/index.js

@@ -15,45 +15,60 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import * as readline from "node:readline";
 import { spawn, spawnSync } from "node:child_process";
-import { HOME, browserDir, configDir, die, ensureRoot, identity, listAllProfiles, listProfiles, migrateLegacyLayout, profileDir, profileExists, readJson, requireProfile, activeFor, setActive, labelFor, setLabel, clearLabel, renameProfile, isProfileLabel, PROFILE_LABELS, readAutoSwitch, readAutoSwitchAll, setAutoSwitch, readOsNotifications, setOsNotifications, readProviders, setProviderSurface, readBinaryPath, readGuard, setGuard, readBinaryPaths, setBinaryPath, ROOT, resetRebindKillSwitch, } from "./profiles.js";
+import { HOME, browserDir, configDir, die, ensureRoot, identity, listAllProfiles, listProfiles, migrateLegacyLayout, profileDir, profileExists, readJson, requireProfile, activeFor, setActive, labelFor, setLabel, clearLabel, colorOf, isDisabled, setSharesDefaultLogin, sharesDefaultLogin, setDisabled, setColor, isProfileColor, PROFILE_COLORS, renameProfile, isProfileLabel, PROFILE_LABELS, readAutoSwitch, readAutoSwitchAll, setAutoSwitch, readOsNotifications, setOsNotifications, readProviders, setProviderSurface, readBinaryPath, readGuard, setGuard, readBinaryPaths, setBinaryPath, ROOT, resetRebindKillSwitch, } from "./profiles.js";
+import { browserWrapperScript, defaultBrowserDeps, listBrowsers, locateBrowser } from "./browsers.js";
 import { PROVIDER_IDS, provider, isProviderInstalled, resolveBinary } from "./providers.js";
-import { rebind, restoreRebind } from "./rebind.js";
+import { borrowerOf, discardBinding, readBinding, rebind, releaseBorrowedAccount, restoreRebind } from "./rebind.js";
 import { buildRebindDialog, resolveRebindChoice, selectableRows } from "./rebind-dialog.js";
 import { parseArgs, parseRun, resolveProviderValue } from "./args.js";
 import { extractBrief, writeBrief, sweepBriefs, seedPrompt } from "./handoff.js";
 import { credentialStore } from "./credentials.js";
 import { withProperLock } from "./locks.js";
-import { applySharing, removeSharing, syncSharing, sharedLinkHealth } from "./share.js";
+import { applySharing, removeSharing, syncSharing, sharedLinkHealth, PROMPT_HISTORY } from "./share.js";
 import { assertNotFull, exportConfig, importConfig } from "./config-transfer.js";
-import { detectShell, shellenvScript } from "./shellenv.js";
-import { runDoctor } from "./doctor.js";
+import { detectShell, installShellIntegration, shellenvScript } from "./shellenv.js";
+import { runDoctor, shellIntegrationCheck } from "./doctor.js";
+import { appendActivity, readActivity, ACTIVITY_MAX_LINES } from "./activity.js";
+import { readGuiSettings, writeGuiSettings, applyGuiSetting } from "./gui-settings.js";
+import { readProtection, setProtection, renameProtection, forgetProtection } from "./protection.js";
+import { POOL_PREFIX, addPoolMember, createPool, deletePool, findPool, isPoolRef, parseMember, poolIdOf, readPools, removePoolMember, renamePool, renamePoolMember, suggestPoolsFromLabels, } from "./pools.js";
+import { resolveForDir } from "./dir-resolve.js";
+import { antigravityAuthStatus, claudeAuthStatus, claudeCredentialFile, codexAuthStatus, fileMtimeMs, readText, keptFreshByFor, } from "./auth-status.js";
 import { TOOL_IDS, checkTooling, formatToolNotes, formatToolingLines, runToolAction, toolNotesRefusal, toolReleaseRepo, } from "./tooling.js";
 import { releaseNoteBlocks } from "./release-notes.js";
-import { readHistory, recordHistorySample } from "./history.js";
+import { LATEST_FILE, readHistory, readLatestSnapshot, recordHistorySample, writeLatestSnapshot } from "./history.js";
 import { launchGui } from "./gui-launch.js";
 import { GUARD_POLICIES, GUARD_REFUSED_EXIT, OVERRIDE_ENV, guardVerdict, inspectLoad, isGuardPolicy, overrideFromEnv, renderGuardMessage, } from "./single-load.js";
 import { checkForUpdate, fetchReleases, releasesNewerThan, selfUpdate } from "./updates.js";
-import { mappingRows, pruneMappings, removeMapping, resolveMapping, setMapping, } from "./mappings.js";
+import { mappingRows, pruneMappings, removeMapping, resolveMapping, setMapping, setPaused, normalizePath, } from "./mappings.js";
 import { checkAuth, fetchProfile, fetchUsage, liveSessionPids, } from "./api.js";
-import { defaultFreshenDeps, freshAccessToken } from "./token-freshen.js";
+import { defaultFreshenDeps, usageToken } from "./token-freshen.js";
 import { formatSnapshot, parseUsage } from "./usage.js";
 import { readCodexUsage } from "./codex-usage.js";
 import { redeemResetCredit } from "./codex-reset.js";
-import { assertValidSessionId, cleanupForkVehicle, codexSessionCommand, deleteSession, detectRunningClaudeProfile, listSessions, listCodexSessions, locateSession, locateCodexSession, markLive, restoreSession, sharedHistory, sweepTrash, transferSession, transferCodexSession, trashedSessionExists, } from "./sessions.js";
+import { assertValidSessionId, cleanupForkVehicle, codexSessionCommand, deleteSession, detectRunningClaudeProfile, listSessions, listCodexSessions, locateSession, locateCodexSession, markLive, openQuestion, restoreSession, sharedHistory, sweepTrash, transferSession, transferCodexSession, trashedSessionExists, } from "./sessions.js";
 import { isFresh, readDaemonState, readPid, PIDFILE, processAlive } from "./daemon.js";
-import { cmdService, serviceUninstall } from "./service.js";
+import { cmdService, serviceAfterUpdate, serviceInstall, serviceInstallFromDisk, serviceTarget, serviceUninstall } from "./service.js";
+import { fileURLToPath } from "node:url";
 import { readContext, turnInFlight } from "./telemetry.js";
 import { readPreview } from "./session-preview.js";
-import { installHooks, uninstallHooks, hooksInstalled, readSettings, appendEvent, eventFile, profileFromConfigDir, } from "./hooks.js";
+import { installHooks, uninstallHooks, hooksInstalled, readSettings, appendEvent, eventFile, profileFromConfigDir, readEvents, waitingSessions, } from "./hooks.js";
 import { readTelemetryConfig, writeTelemetryConfig } from "./notify.js";
 import { appendNotification, readNotifications, clearNotifications } from "./notifications.js";
 import { APPS, buildLaunch, findApp, guiDataDir, isInstalled } from "./apps.js";
+import { copyDesktopSettings, DEFAULT_DATA_DIR, hasSettingsLayout } from "./desktop-settings.js";
+import { createLauncher, findRunning, focusRunning, readLaunchers, removeAllLaunchers, removeLauncher, removeLaunchersFor, renameLaunchersFor, repairLaunchers, } from "./launchers.js";
+import { scanDesktop } from "./desktop-sessions.js";
 import { ensureAgyKeychain } from "./agy-keychain.js";
 import { currentManagedSession, currentTmuxSessionName, newSessionArgs, readTmuxRegistry, recordManagedSession, respawnPaneArgs, sendKeysArgs, tmuxAvailable, tmuxSessionName, } from "./tmux.js";
 // Per-OS credential store (keychain-then-file on darwin, file-only elsewhere).
 const credentials = credentialStore();
 const CLAUDE_HOME = provider("claude").defaultConfigDir(); // ~/.claude
 const CLAUDE_JSON = path.join(HOME, ".claude.json");
+/** Record one of agent-switch's own actions in the activity log (never a token). */
+function logActivity(kind, target, action, reason, ok = true) {
+    appendActivity({ kind, target, action, reason, ok });
+}
 /** Same-provider profiles that carry no live session — the concrete
  *  alternatives a refusal names, so the user can act on it without first
  *  running `list` themselves. */
@@ -95,9 +110,9 @@ function checkSingleLoad(providerId, name, opts = {}) {
     };
 }
 // ---------- launcher ---------------------------------------------------------
-function launch(p, name, args) {
+function launch(p, name, args, extraEnv = {}) {
     const home = configDir(p.id, name);
-    const env = { ...process.env, [p.envVar]: home };
+    const env = { ...process.env, ...extraEnv, [p.envVar]: home };
     // Antigravity's agy CLI stores its token in the macOS keychain (fixed key) —
     // seed a per-profile keychain under this HOME so the token is isolated per
     // account (and macOS doesn't pop its "no keychain found" dialog). No-op off mac.
@@ -115,20 +130,114 @@ function launch(p, name, args) {
     return res.status ?? 1;
 }
 // ---------- commands ---------------------------------------------------------
-function cmdAdd(providerId, name) {
+function cmdAdd(providerId, name, browserId) {
     if (!name)
-        die(`usage: agent-switch add [--provider ${providerId}] <profile>`);
+        die(`usage: agent-switch add [--provider ${providerId}] <profile> [--browser B]`);
     if (profileExists(providerId, name))
         die(`profile "${name}" already exists for ${providerId}`);
     const p = provider(providerId);
+    const env = browserId ? browserEnv(browserId, providerId) : {};
     ensureRoot();
-    fs.mkdirSync(configDir(providerId, name), { recursive: true, mode: 0o700 });
+    const dir = configDir(providerId, name);
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    // A bare `claude` in a fresh config dir opens Claude Code's setup screens, not
+    // the sign-in; skip them the way `import` does and run the sign-in itself.
+    if (providerId === "claude")
+        seedClaudeOnboarding(dir);
     console.log(`Created ${providerId} profile "${name}".`);
-    console.log(`Launching ${p.binary} for first login (log in inside if prompted)...`);
-    launch(p, name, []);
+    const loginArgs = LOGIN_ARGS[providerId];
+    console.log(loginArgs.length
+        ? `Signing it in with \`${[p.binary, ...loginArgs].join(" ")}\` (finish it in the browser if one opens)...`
+        : `Launching ${p.binary} for first login (log in inside if prompted)...`);
+    const code = launch(p, name, loginArgs, env);
     const id = identity(providerId, name);
-    console.log(id ? `Profile "${name}" is linked to ${id}.` : `Profile "${name}" created.`);
-    console.log(`Activate it with: agent-switch use ${name}${providerId === "claude" ? "" : ` --provider ${providerId}`}`);
+    const after = authStatusFor(providerId, name);
+    const ok = !!id || after.state === "connected" || after.state === "expiring";
+    logActivity("login", `${providerId}/${name}`, ok ? "signed in (new profile)" : "created, sign-in not confirmed", "user ran `agent-switch add`", ok);
+    const flag = providerId === "claude" ? "" : ` --provider ${providerId}`;
+    if (!ok && loginArgs.length) {
+        console.error(`Profile "${name}" was created but is not signed in yet${code !== 0 ? ` (${p.binary} exited with ${code})` : ""}. Finish it with: agent-switch login ${name}${flag}`);
+        process.exit(1);
+    }
+    console.log(id ? `Profile "${name}" is signed in as ${id}.` : ok ? `Profile "${name}" is signed in.` : `Profile "${name}" created.`);
+    console.log(`Activate it with: agent-switch use ${name}${flag}`);
+}
+/** Mark Claude Code's first-run setup as done in a new profile (theme taken
+ *  from the default install), so its first start goes straight to work. */
+function seedClaudeOnboarding(dir) {
+    const file = path.join(dir, ".claude.json");
+    const config = (fs.existsSync(file) && readJson(file)) || {};
+    const theme = (fs.existsSync(CLAUDE_JSON) && readJson(CLAUDE_JSON)?.theme) || "dark";
+    config.hasCompletedOnboarding = true;
+    config.theme = config.theme || theme;
+    fs.writeFileSync(file, JSON.stringify(config, null, 2) + "\n", { mode: 0o600 });
+}
+/**
+ * `$BROWSER` for a sign-in in one specific browser. Only Claude Code is verified
+ * to follow it; codex on macOS opens the system default regardless, so it is
+ * told rather than silently ignored.
+ */
+function browserEnv(browserId, providerId) {
+    if (process.platform === "win32")
+        die("--browser is not supported on Windows yet.");
+    const deps = defaultBrowserDeps(HOME);
+    const located = locateBrowser(browserId, deps);
+    if (!located) {
+        const installed = listBrowsers(deps).map((b) => b.id).join(", ") || "(none found)";
+        die(`browser "${browserId}" is not installed. Installed: ${installed}`);
+    }
+    if (providerId !== "claude") {
+        console.log(`Note: ${provider(providerId).binary} opens your default browser itself. If that is the wrong one, open the link it prints in ${browserId} — the sign-in works from any browser.`);
+    }
+    if (process.platform !== "darwin")
+        return { BROWSER: located };
+    const wrapper = path.join(ROOT, "browsers", browserId);
+    fs.mkdirSync(path.dirname(wrapper), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(wrapper, browserWrapperScript(located), { mode: 0o700 });
+    fs.chmodSync(wrapper, 0o700);
+    return { BROWSER: wrapper };
+}
+function cmdBrowsers(json) {
+    const list = listBrowsers(defaultBrowserDeps(HOME));
+    if (json)
+        return void console.log(JSON.stringify(list, null, 2));
+    if (list.length === 0)
+        return void console.log("No supported browsers found.");
+    for (const b of list)
+        console.log(`${b.id.padEnd(16)} ${b.name}`);
+}
+/** The provider's own sign-in command for an existing profile. Antigravity's
+ *  agy has no separate login command; it prompts when it starts signed out. */
+const LOGIN_ARGS = {
+    claude: ["auth", "login"],
+    codex: ["login"],
+    antigravity: [],
+};
+/**
+ * Sign an existing profile in again — `add` refuses a name that exists, and a
+ * login the provider cleared (signed out, refresh window ended) needs exactly
+ * this. Runs the provider's own sign-in under the profile's config dir, then
+ * reads the stored login back: the identity in the config outlives a sign-out,
+ * so only the credential proves the sign-in happened.
+ */
+function cmdLogin(providerId, name, browserId) {
+    const n = requireProfile(providerId, name, "login");
+    const p = provider(providerId);
+    const env = browserId ? browserEnv(browserId, providerId) : {};
+    console.log(`Signing ${providerId}/${n} in with \`${[p.binary, ...LOGIN_ARGS[providerId]].join(" ")}\` (finish it in the browser if one opens)...`);
+    const code = launch(p, n, LOGIN_ARGS[providerId], env);
+    const after = authStatusFor(providerId, n);
+    const ok = after.state === "connected" || after.state === "expiring";
+    logActivity("login", `${providerId}/${n}`, ok ? "signed in again" : "sign-in not confirmed", "user ran `agent-switch login`", ok);
+    if (!ok) {
+        console.error(`${providerId}/${n} is still not signed in (${after.detail})${code !== 0 ? ` — ${p.binary} exited with ${code}` : ""}.`);
+        process.exit(1);
+    }
+    // Its own sign-in ends the lineage it shared with the default install.
+    if (sharesDefaultLogin(providerId, n))
+        setSharesDefaultLogin(providerId, n, false);
+    const id = identity(providerId, n);
+    console.log(`${providerId}/${n} is signed in${id ? ` as ${id}` : ""}.`);
 }
 /**
  * Login-free import of the default Claude install into a profile. Takes Claude
@@ -158,6 +267,8 @@ async function importClaude(name) {
             fs.writeFileSync(path.join(dst, ".credentials.json"), creds, { mode: 0o600 });
         return creds !== null;
     }));
+    if (seeded)
+        setSharesDefaultLogin("claude", name, true);
     console.log(`Imported default Claude setup into profile "${name}".`);
     console.log(seeded
         ? "Credentials were seeded — no re-login needed. Claude Code migrates the seed into\n" +
@@ -185,6 +296,8 @@ function importFileProvider(p, name) {
         if (path.join(srcDir, file) === p.credentialPath(srcDir))
             seeded = true;
     }
+    if (seeded)
+        setSharesDefaultLogin(p.id, name, true);
     console.log(`Imported default ${p.binary} setup into profile "${name}".`);
     console.log(seeded
         ? `Credential seeded — no re-login needed.\nIMPORTANT: this profile shares one OAuth ` +
@@ -203,7 +316,10 @@ async function cmdImport(providerId, name) {
 }
 function cmdUse(providerId, name) {
     const n = requireProfile(providerId, name, "use");
+    if (isDisabled(providerId, n))
+        die(`${n} is disabled — turn it back on first: agent-switch enable ${n}${providerId === "claude" ? "" : ` --provider ${providerId}`}`);
     setActive(providerId, n);
+    logActivity("switch", `${providerId}/${n}`, "set as active profile", "user ran `agent-switch use`");
     const id = identity(providerId, n);
     console.log(`Active ${providerId} profile: ${n}${id ? ` (${id})` : ""}`);
     console.log(`New \`${provider(providerId).binary}\` sessions use this profile. Running sessions are unaffected.`);
@@ -223,11 +339,17 @@ function cmdDeactivate(providerId) {
         return;
     }
     setActive(providerId, null);
+    logActivity("switch", `${providerId}/${active}`, "deactivated", "user ran `agent-switch deactivate`");
     console.log(`Deactivated ${providerId} profile "${active}". No ${providerId} profile is active.`);
     console.log(`New \`${provider(providerId).binary}\` sessions fall back to the default install until you \`use\` one.`);
 }
-function cmdRun(providerId, name, args) {
+function cmdRun(providerId, name, args, cwd) {
     const n = requireProfile(providerId, name, "run");
+    if (cwd !== undefined) {
+        if (!fs.existsSync(cwd) || !fs.statSync(cwd).isDirectory())
+            die(`no such folder: ${cwd}`);
+        process.chdir(cwd);
+    }
     const p = provider(providerId);
     // `--tmux` and `--force` are agent-switch flags, not passthrough flags — strip
     // them before the rest reaches the provider binary.
@@ -287,6 +409,8 @@ function cmdList(providerId, json = false) {
             name: n,
             identity: identity(pid, n),
             label: labelFor(pid, n),
+            color: colorOf(pid, n),
+            disabled: isDisabled(pid, n),
             active: activeFor(pid) === n,
             liveSessions: pid === "claude" ? liveSessionPids(configDir("claude", n)).length : 0,
         })));
@@ -340,7 +464,7 @@ async function claudeSnapshot(name) {
         if (cached)
             return cached;
     }
-    const token = freshAccessToken(configDir("claude", name), defaultFreshenDeps(readBinaryPath("claude")));
+    const token = usageToken(configDir("claude", name), defaultFreshenDeps(readBinaryPath("claude")), sharesDefaultLogin("claude", name));
     if (!token)
         return null;
     const raw = await fetchUsage(token);
@@ -366,8 +490,11 @@ async function cmdStatus(providerId, name, json = false) {
         // every displayed profile on each refresh, so recording the fresh snapshot
         // here (throttled to ~hourly) fills the chart for all profiles without
         // depending on the background daemon or an "active" profile being set.
-        if (usage)
+        if (usage) {
             recordHistorySample(path.join(profileDir(pid, active), "usage-history.json"), usage);
+            // Unthrottled: `dir` balances on usage only while it is minutes old.
+            writeLatestSnapshot(path.join(profileDir(pid, active), LATEST_FILE), usage);
+        }
         const wc = worstLiveContext(pid, active);
         const context = wc
             ? { sessionId: wc.sessionId, pct: wc.pct, contextTokens: wc.contextTokens, windowTokens: wc.windowTokens, model: wc.model, confidence: wc.confidence }
@@ -401,9 +528,12 @@ async function cmdStatus(providerId, name, json = false) {
             console.log("  (no usage readout for this provider — shows own usage only where available)");
             continue;
         }
-        const token = freshAccessToken(configDir("claude", n), defaultFreshenDeps(readBinaryPath("claude")));
+        const token = usageToken(configDir("claude", n), defaultFreshenDeps(readBinaryPath("claude")), sharesDefaultLogin("claude", n));
         if (!token) {
-            console.log("  (credential not readable — profile may not have run yet)");
+            const auth = authStatusFor("claude", n);
+            console.log(auth.state === "sign-in-needed"
+                ? `  (signed out — sign in again: agent-switch login ${n})`
+                : "  (credential not readable — profile may not have run yet)");
             continue;
         }
         const [profileInfo, raw] = await Promise.all([fetchProfile(token), fetchUsage(token)]);
@@ -425,6 +555,61 @@ async function cmdStatus(providerId, name, json = false) {
         }
     }
 }
+/** Cached usage for one profile: the daemon's snapshot or the newest history
+ *  sample, whichever is newer. Local reads only — `dir` runs on every start. */
+function cachedUsage(providerId, name) {
+    const fromDaemonOrHistory = cachedUsageFromDaemonOrHistory(providerId, name);
+    // The app's own reads land here unthrottled; take whichever source is newest.
+    const latest = readLatestSnapshot(path.join(profileDir(providerId, name), LATEST_FILE));
+    return latest && (fromDaemonOrHistory.capturedMs === null || latest.capturedMs > fromDaemonOrHistory.capturedMs) ? latest : fromDaemonOrHistory;
+}
+function cachedUsageFromDaemonOrHistory(providerId, name) {
+    const daemonSnap = readDaemonState()?.profiles?.[`${providerId}/${name}`] ?? null;
+    const daemonMs = daemonSnap ? Date.parse(daemonSnap.capturedAt) : NaN;
+    const hist = readHistory(path.join(profileDir(providerId, name), "usage-history.json"));
+    const last = hist.length ? hist[hist.length - 1] : null;
+    const histMs = last ? Date.parse(last.at) : NaN;
+    if (last && !isNaN(histMs) && (isNaN(daemonMs) || histMs > daemonMs)) {
+        // History samples keep no reset time; the daemon's last one still holds
+        // while it lies ahead (a window's reset only moves once it has passed).
+        const resetOf = (key) => {
+            const r = daemonSnap?.windows.find((d) => d.key === key)?.resetsAt ?? null;
+            return r && Date.parse(r) > histMs ? r : null;
+        };
+        const windows = last.windows.map((w) => ({ key: w.key, label: w.key, utilization: w.utilization, resetsAt: resetOf(w.key) }));
+        return { snapshot: { windows, routines: null, capturedAt: last.at }, capturedMs: histMs };
+    }
+    return { snapshot: daemonSnap, capturedMs: isNaN(daemonMs) ? null : daemonMs };
+}
+function tildePath(p) {
+    return p === HOME || p.startsWith(HOME + path.sep) ? "~" + p.slice(HOME.length) : p;
+}
+/** Profile names are validated by `profileDir`, which exits on a bad name —
+ *  a pool ref or a stale mapping must never kill the shell wrapper's hot path. */
+function profileExistsSafe(providerId, name) {
+    return /^[A-Za-z0-9_-]+$/.test(name) && profileExists(providerId, name);
+}
+function resolveDir(providerId, plain = false) {
+    return resolveForDir({
+        providerId,
+        mapping: plain ? null : resolveMapping(process.cwd(), providerId),
+        names: listProfiles(providerId),
+        threshold: (n) => readProtection(providerId, n).thresholdPct,
+        active: activeFor(providerId),
+        exists: (n) => profileExistsSafe(providerId, n),
+        signedIn: (n) => identity(providerId, n) !== null,
+        disabled: (n) => isDisabled(providerId, n),
+        sharesDefaultLogin: (n) => profileExistsSafe(providerId, n) && sharesDefaultLogin(providerId, n),
+        pool: (id) => findPool(id),
+        usage: (n) => cachedUsage(providerId, n),
+        // Only providers that write a live-session signal can report one; the
+        // check runs for pool members only.
+        live: (n) => provider(providerId).hasLiveSessionSignal && liveSessionPids(configDir(providerId, n)).length > 0,
+        guard: readGuard(),
+        now: Date.now(),
+        displayPath: tildePath,
+    });
+}
 /**
  * Resolve which profile a shell wrapper should load: directory mapping (nearest
  * ancestor of CWD) > active-for-provider. Empty output → the wrapper falls back
@@ -436,14 +621,26 @@ async function cmdStatus(providerId, name, json = false) {
  * and talk to the human; a distinct exit code is what lets the wrapper block on
  * a refusal without ever blocking on a missing or older `agent-switch`.
  */
-function cmdDir(providerId, guarded = false) {
-    const mapped = resolveMapping(process.cwd(), providerId);
-    const name = mapped && profileExists(providerId, mapped.name)
-        ? mapped.name
-        : (() => {
-            const active = activeFor(providerId);
-            return active && profileExists(providerId, active) ? active : null;
-        })();
+function cmdDir(providerId, guarded = false, json = false, plain = false) {
+    const r = resolveDir(providerId, plain);
+    if (json) {
+        console.log(JSON.stringify({
+            profile: r.name ? `${providerId}/${r.name}` : null,
+            configDir: r.name ? configDir(providerId, r.name) : null,
+            why: r.why,
+            ...(r.blocked ? { blocked: r.blocked } : {}),
+        }, null, 2));
+        if (r.blocked)
+            process.exit(GUARD_REFUSED_EXIT);
+        return;
+    }
+    // A folder rule that cannot be served refuses — starting on an account
+    // outside the rule is the one outcome the rule exists to prevent.
+    if (r.blocked) {
+        console.error(`agent-switch: not starting here — ${r.blocked}.`);
+        process.exit(GUARD_REFUSED_EXIT);
+    }
+    const name = r.name;
     if (!name)
         return;
     console.log(configDir(providerId, name));
@@ -457,8 +654,28 @@ function cmdDir(providerId, guarded = false) {
     if (guard.verdict === "refuse")
         process.exit(GUARD_REFUSED_EXIT);
 }
-function cmdMap(providerId, name, dir) {
-    const n = requireProfile(providerId, name, `map [--provider ${providerId}] <profile> [dir]`);
+function cmdMap(providerId, name, dir, flags = {}) {
+    if (flags.pause || flags.resume) {
+        // `map --pause [dir]`: the positional is the folder, there is no profile.
+        const target = name ?? process.cwd();
+        const on = !!flags.pause;
+        if (!setPaused(target, providerId, on))
+            die(`no mapping for ${target} (${providerId})`);
+        console.log(on
+            ? `Paused the ${providerId} rule for ${normalizePath(target)} — it stays listed but no longer picks the account. Resume: agent-switch map --resume ${target}`
+            : `Resumed the ${providerId} rule for ${normalizePath(target)}.`);
+        return;
+    }
+    if (name && isPoolRef(name)) {
+        const pool = findPool(poolIdOf(name));
+        if (!pool)
+            die(`no pool "${poolIdOf(name)}" — create it with: agent-switch pool create <name>`);
+        const key = setMapping(dir ?? process.cwd(), providerId, `${POOL_PREFIX}${pool.id}`);
+        console.log(`Mapped ${key} -> pool ${pool.id} (${providerId})`);
+        console.log(`\`${provider(providerId).binary}\` here starts on the ${providerId} member of "${pool.name}" with the most fresh headroom. See why: agent-switch dir --json`);
+        return;
+    }
+    const n = requireProfile(providerId, name, `map [--provider ${providerId}] <profile|pool:<id>> [dir]`);
     const key = setMapping(dir ?? process.cwd(), providerId, n);
     console.log(`Mapped ${key} -> ${providerId}/${n}`);
     console.log(`\`${provider(providerId).binary}\` in this directory (and subdirectories) now uses this profile.`);
@@ -470,14 +687,20 @@ function cmdUnmap(providerId, dir) {
     else
         die(`no mapping for ${target}${providerId ? ` (${providerId})` : ""}`);
 }
-function cmdMappings() {
+function cmdMappings(json = false) {
     const rows = mappingRows();
+    if (json) {
+        console.log(JSON.stringify(rows.map((r) => ({ path: r.path, provider: r.provider, target: r.name, paused: r.paused }))));
+        return;
+    }
     if (rows.length === 0) {
         console.log("No directory mappings. Create one with: agent-switch map <profile> [dir]");
         return;
     }
-    for (const r of rows)
-        console.log(`${r.path} -> ${r.provider}/${r.name}`);
+    for (const r of rows) {
+        const line = isPoolRef(r.name) ? `${r.path} -> ${r.name} (${r.provider})` : `${r.path} -> ${r.provider}/${r.name}`;
+        console.log(r.paused ? `${line}  [paused]` : line);
+    }
 }
 // share + web are Claude-config concepts and stay Claude-scoped.
 function cmdShare(mode, flags = []) {
@@ -503,7 +726,9 @@ function cmdShare(mode, flags = []) {
             const actions = applySharing(source, configDir("claude", p), withHistory);
             console.log(`  ${p}: ${actions.length > 0 ? actions.join(", ") : "up to date"}`);
         }
-        console.log("Shared directories (skills/, commands/, agents/) write through the link. Shared files\n" +
+        console.log("Prompt history (history.jsonl — what ↑ and Ctrl+R search) is shared too; a profile's own\n" +
+            "file was merged in and kept as history.jsonl.pre-share.\n" +
+            "Shared directories (skills/, commands/, agents/) write through the link. Shared files\n" +
             "(settings.json, ...) fork on an in-profile /config edit — run `agent-switch share sync`\n" +
             "to push a fork back to the source and re-link.");
     }
@@ -529,7 +754,11 @@ function cmdShare(mode, flags = []) {
         // flag: sharing is active when any profile carries agent-switch-managed links.
         const rows = profiles
             .filter((p) => configDir("claude", p) !== source)
-            .map((p) => ({ name: p, shared: sharedLinkHealth(configDir("claude", p)).length > 0 }));
+            .map((p) => {
+            const links = sharedLinkHealth(configDir("claude", p));
+            const prompts = links.some((l) => l.name === PROMPT_HISTORY && l.state === "linked");
+            return { name: p, shared: links.length > 0, prompts };
+        });
         const active = rows.some((r) => r.shared);
         if (flags.includes("--json")) {
             console.log(JSON.stringify({ active, source: sourceName ?? "default", profiles: rows }));
@@ -537,7 +766,7 @@ function cmdShare(mode, flags = []) {
         }
         console.log(`share: ${active ? "on" : "off"} (source ${sourceName ?? "default"})`);
         for (const r of rows)
-            console.log(`  ${r.name}: ${r.shared ? "shared" : "own"}`);
+            console.log(`  ${r.name}: ${r.shared ? "shared" : "own"}${r.shared && !r.prompts ? " (prompt history not linked — run share on)" : ""}`);
     }
     else {
         die("usage: agent-switch share on|sync|off|status [--history] [--source <profile|default>]");
@@ -822,6 +1051,40 @@ function cmdHookEvent() {
  * GUI contract: a flat array, metadata only — transcript content never leaves
  * the profile dir (only the guarded first-line header is read).
  */
+/** The regular Desktop app's data dir, then every profile's own instance. */
+function desktopInstances() {
+    const app = findApp("claude-desktop");
+    const regular = process.platform === "darwin"
+        ? path.join(HOME, "Library", "Application Support", "Claude")
+        : process.platform === "win32"
+            ? path.join(process.env.APPDATA ?? path.join(HOME, "AppData", "Roaming"), "Claude")
+            : path.join(HOME, ".config", "Claude");
+    return [{ profile: null, dir: regular }, ...(app ? listProfiles("claude").map((p) => ({ profile: p, dir: guiDataDir(app, p) })) : [])];
+}
+function desktopScan() {
+    const byAccount = new Map();
+    for (const p of listProfiles("claude")) {
+        const uuid = readJson(path.join(configDir("claude", p), ".claude.json"))?.oauthAccount?.accountUuid;
+        if (typeof uuid === "string")
+            byAccount.set(uuid, p);
+    }
+    return scanDesktop({ instances: desktopInstances(), claudeHome: CLAUDE_HOME, profileOf: (u) => byAccount.get(u) ?? null, now: Date.now() });
+}
+/** Which accounts ran sessions in each Claude Desktop instance; `mismatch` =
+ *  a profile's own instance signed in with another account. */
+function cmdDesktop(json) {
+    const { instances } = desktopScan();
+    const shown = instances.filter((i) => i.accounts.length > 0);
+    if (json)
+        return void console.log(JSON.stringify(shown, null, 2));
+    if (!shown.length)
+        return void console.log("No Claude Desktop sessions found.");
+    for (const i of shown) {
+        console.log(`${i.profile ? `${i.profile}'s instance` : "Claude Desktop"} (${tildePath(i.dir)})`);
+        for (const a of i.accounts)
+            console.log(`  ${a.profile ?? "an account without a profile"} (${a.accountUuid.slice(0, 8)})${i.profile && a.profile !== i.profile ? "  <- not this profile's account" : ""}`);
+    }
+}
 function cmdSessions(providerId, providerExplicit, name, flags = {}) {
     if (providerExplicit && providerId !== "claude" && providerId !== "codex") {
         die(`sessions supports claude and codex for now (${providerId} parity is gated on its Phase-0 spike — see scripts/spikes/)`);
@@ -834,6 +1097,8 @@ function cmdSessions(providerId, providerExplicit, name, flags = {}) {
     if (profiles.length === 0)
         die(`no ${providerId} profiles`);
     const all = [];
+    // Claude Desktop's own sessions, filed by account (see desktop-sessions.ts).
+    const desktop = providerId === "claude" ? desktopScan().rows : [];
     for (const p of profiles) {
         const cfg = configDir(providerId, p);
         // Codex stores date-partitioned rollout files (no encoded-cwd dir); its live
@@ -842,7 +1107,24 @@ function cmdSessions(providerId, providerExplicit, name, flags = {}) {
         const rows = providerId === "codex" ? listCodexSessions(cfg, limit) : listSessions(cfg, limit);
         if (providerId === "claude")
             markLive(cfg, rows); // POSIX: pid→cwd→dir match; win32: recent-only
-        all.push(...rows.map((r) => ({ ...r, profile: p })));
+        if (providerId === "claude") {
+            const mtime = new Map(rows.map((r) => [r.sessionId, r.mtimeMs]));
+            const waiting = waitingSessions(readEvents(eventFile(ROOT, providerId, p)), (id) => mtime.get(id) ?? null);
+            // Hooks report a prompt; an open question also shows in the transcript itself.
+            for (const r of rows) {
+                const why = (r.file ? openQuestion(r.file) : null) ?? waiting.get(r.sessionId) ?? null;
+                if (why)
+                    Object.assign(r, { waiting: true, waitingFor: why });
+            }
+        }
+        const own = new Set(rows.map((r) => r.sessionId));
+        for (const d of desktop)
+            if (d.profile === p && !own.has(d.sessionId)) {
+                const q = d.file ? openQuestion(d.file) : null;
+                rows.push(q ? { ...d, waiting: true, waitingFor: q } : d);
+            }
+        rows.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        all.push(...rows.slice(0, limit).map((r) => ({ ...r, profile: p })));
     }
     if (flags.json) {
         console.log(JSON.stringify(all.map((r) => {
@@ -1319,7 +1601,25 @@ function takeoverCodex(sessionId, target, opts) {
     if (!printOnly && process.stdin.isTTY)
         process.exit(launch(provider("codex"), target, resumeArgs));
 }
-function cmdRemove(providerId, name, force = false) {
+/**
+ * Ask before a destructive or scarce-credit action. `--yes` skips the question.
+ * Off a terminal there is nobody to ask, so the action proceeds as it always
+ * did (scripts and the GUI, which confirms in its own UI, keep working) and a
+ * note on stderr says how to make that explicit.
+ */
+async function confirmAction(question, yes) {
+    if (yes)
+        return true;
+    if (!process.stdin.isTTY) {
+        console.error("agent-switch: not a terminal — proceeding without confirmation (pass --yes to make this explicit).");
+        return true;
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => rl.question(`${question} [y/N] `, resolve));
+    rl.close();
+    return /^y(es)?$/i.test(answer.trim());
+}
+async function cmdRemove(providerId, name, force = false, yes = false) {
     const n = requireProfile(providerId, name, "remove");
     if (activeFor(providerId) === n && !force) {
         die(`"${n}" is the active ${providerId} profile. Switch away first or use --force.`);
@@ -1330,15 +1630,54 @@ function cmdRemove(providerId, name, force = false) {
             die(`profile "${n}" has live Claude Code sessions (PIDs ${pids.join(", ")}). Close them or use --force.`);
         }
     }
+    // An active rebind keeps both original credentials in two Keychain stash
+    // entries. Deleting the profile would orphan them — restore first.
+    const binding = providerId === "claude" ? readBinding(configDir("claude", n)) : null;
+    if (binding && !force) {
+        die(`profile "${n}" is rebound to "${binding.boundToProfile}"'s account. Restore it first: ` +
+            `agent-switch rebind --restore --profile ${n} — or use --force to drop the rebind (its stashed credentials are deleted).`);
+    }
+    // The reverse case: another profile is serving THIS profile's account. Its
+    // restore would write into the store of a profile that no longer exists.
+    const borrower = providerId === "claude" ? borrowerOf(n) : null;
+    if (borrower && !force) {
+        die(`profile "${n}"'s account is currently borrowed by "${borrower}" (rebind). Restore it first: ` +
+            `agent-switch rebind --restore --profile ${borrower} — or use --force to restore "${borrower}" and then remove "${n}".`);
+    }
+    const who = identity(providerId, n);
+    if (!(await confirmAction(`Remove ${providerId} profile "${n}"${who ? ` (${who})` : ""} and its login? This cannot be undone.`, yes))) {
+        console.log("Cancelled — nothing removed.");
+        return;
+    }
     // Keychain entries exist only for claude (darwin); codex/antigravity are file-based,
     // so computing a Claude hash for them would be a conceptual no-op — skip it.
+    let restoredBorrower = null;
+    if (borrower) {
+        try {
+            restoredBorrower = await releaseBorrowedAccount(n);
+        }
+        catch (e) {
+            die(`could not restore "${borrower}" first, so "${n}" was not removed: ${e.message}`);
+        }
+        if (restoredBorrower)
+            logActivity("rebind", `claude/${restoredBorrower}`, `restored own account (was on ${n})`, "user ran `agent-switch remove --force`");
+    }
+    const droppedRebind = binding ? discardBinding(n) : false;
     const removedEntry = providerId === "claude" ? credentials.removeEntry(configDir(providerId, n)) : false;
+    removeLaunchersFor(providerId, n); // they would start a profile that no longer exists
     fs.rmSync(profileDir(providerId, n), { recursive: true, force: true });
     if (activeFor(providerId) === n)
         setActive(providerId, null);
     clearLabel(providerId, n); // drop its label so it can't linger as an orphan
     const pruned = pruneMappings(providerId, n);
+    forgetProtection(providerId, n);
+    renamePoolMember(`${providerId}/${n}`, null);
+    logActivity("remove", `${providerId}/${n}`, "profile removed", yes ? "user ran `agent-switch remove --yes`" : "user ran `agent-switch remove`");
     console.log(`Removed ${providerId} profile "${n}".`);
+    if (restoredBorrower)
+        console.log(`Restored "${restoredBorrower}" to its own account first (it was borrowing "${n}").`);
+    if (droppedRebind)
+        console.log(`Dropped its active rebind (stashed credentials deleted; "${binding.boundToProfile}" keeps its own login).`);
     if (removedEntry)
         console.log("Removed its keychain credential entry.");
     if (pruned.length > 0)
@@ -1363,6 +1702,64 @@ function cmdLabel(providerId, name, label) {
     setLabel(providerId, name, label);
     console.log(`Labeled ${providerId}/${name} as ${label}.`);
 }
+/** Disable keeps a profile (login, history, settings) but takes it out of every
+ *  pick: no active slot, no pool or folder rule, no background polling. */
+/** `mark-shared <name> [--off]`: mark (or unmark) a profile as sharing the
+ *  default install's login — for imports made before `import` set the mark. */
+function cmdMarkShared(providerId, name, off) {
+    const n = requireProfile(providerId, name, "mark-shared");
+    setSharesDefaultLogin(providerId, n, !off);
+    console.log(off
+        ? `${providerId}/${n} no longer counts as sharing the default install's login.`
+        : `${providerId}/${n} now counts as sharing the default install's login: agent-switch never refreshes it and never starts it by balancing. \`agent-switch login ${n}\` gives it its own login.`);
+}
+function cmdDisable(providerId, name, disabled) {
+    const n = requireProfile(providerId, name, disabled ? "disable" : "enable");
+    const wasActive = activeFor(providerId) === n;
+    setDisabled(providerId, n, disabled);
+    if (!disabled)
+        return void console.log(`Turned ${providerId}/${n} back on.`);
+    console.log(`Disabled ${providerId}/${n}. Nothing was deleted; \`agent-switch enable ${n}\` turns it back on.`);
+    if (wasActive)
+        console.log(`It was the active ${providerId} profile — new sessions now use the default login until you pick another.`);
+}
+/**
+ * Make this CLI the one terminals and the background service use. Each app runs
+ * it on start, so a dev build and an installed app each bring their own CLI:
+ * the shell wrapper reads <home>/active-cli, and a service installed from the
+ * other CLI is re-installed onto this one. An uninstalled service stays so.
+ */
+function cmdActivate(json) {
+    const cli = fs.realpathSync(fileURLToPath(import.meta.url));
+    ensureRoot();
+    fs.writeFileSync(path.join(ROOT, "active-cli"), `${cli}\n`, { mode: 0o600 });
+    const before = serviceTarget();
+    if (before === "other-cli")
+        serviceInstall(() => { });
+    const service = before === "other-cli" ? "repointed" : before === "this-cli" ? "unchanged" : "not-installed";
+    if (json)
+        return void console.log(JSON.stringify({ cli, service }));
+    console.log(`Terminals now use ${cli}.`);
+    if (service === "repointed")
+        console.log("The background service was moved onto it.");
+    if (service === "not-installed")
+        console.log("The background service isn't installed (agent-switch service install).");
+}
+function cmdColor(providerId, name, color) {
+    // Like a label, independent state keyed by provider/name: the GUI picks the
+    // colour before `add` has created the profile.
+    if (!name)
+        die(`usage: agent-switch color <profile> [${PROFILE_COLORS.join("|")}|none] [--provider P]`);
+    if (color === undefined || color === "none" || color === "clear") {
+        setColor(providerId, name, null);
+        console.log(`Cleared the colour of ${providerId}/${name}.`);
+        return;
+    }
+    if (!isProfileColor(color))
+        die(`invalid colour "${color}" (choose: ${PROFILE_COLORS.join(", ")}, or "none" to clear)`);
+    setColor(providerId, name, color);
+    console.log(`Coloured ${providerId}/${name} ${color}.`);
+}
 /** Enable/disable opt-in near-limit notifications (notify + suggest, never an
  *  automatic switch), or show the current setting. */
 /** Rename a profile (move its config dir + carry active/label/mappings). */
@@ -1392,15 +1789,23 @@ function cmdRename(providerId, from, to) {
         if (m.provider === providerId && m.name === n)
             setMapping(m.path, providerId, to);
     }
+    renameProtection(providerId, n, to);
+    renamePoolMember(`${providerId}/${n}`, `${providerId}/${to}`);
+    renameLaunchersFor(providerId, n, to);
     console.log(`Renamed ${providerId} profile "${n}" → "${to}".`);
 }
 /** Manually redeem one banked rate-limit reset for a Codex profile. Consumes a
  *  real, scarce credit — the GUI gates this behind a confirmation. */
-async function cmdReset(providerId, name) {
+async function cmdReset(providerId, name, yes = false) {
     if (providerId !== "codex")
         die("reset is only available for codex (banked rate-limit resets).");
     const n = requireProfile("codex", name, "reset");
+    if (!(await confirmAction(`Redeem one banked rate-limit reset for codex/${n}? Credits are scarce and cannot be returned.`, yes))) {
+        console.log("Cancelled — nothing redeemed.");
+        return;
+    }
     const r = await redeemResetCredit(configDir("codex", n));
+    logActivity("redeem", `codex/${n}`, r.ok ? "redeemed one banked reset" : `redeem failed: ${r.reason ?? "unknown"}`, "user ran `agent-switch reset`", r.ok);
     if (r.ok) {
         console.log(`Redeemed a reset for codex/${n} (windows_reset=${r.windowsReset ?? "?"}).`);
     }
@@ -1441,7 +1846,7 @@ function cmdAutoswitch(providerId, providerExplicit, mode, flags = {}) {
         if (cfg.enabled) {
             console.log(`Once the active ${providerId} profile hits the threshold, the daemon NOTIFIES you and SUGGESTS the\n` +
                 "account with the most headroom — it never switches automatically; switching stays a manual action.\n" +
-                "On Codex it redeems a banked reset first (and stays on the account) before suggesting a switch.\n" +
+                "On Codex it also tells you when a banked reset is available — redeeming one stays your call (`agent-switch reset`).\n" +
                 "Run `agent-switch service start` so the daemon is watching.");
         }
         return;
@@ -1528,6 +1933,7 @@ function cmdUninstall(flags = {}) {
         console.log(`  - ${allProfiles.length} profile(s) and their configs under ${ROOT}`);
         console.log(`  - ${claudeProfiles.length} Claude keychain credential entr(y/ies) (macOS)`);
         console.log("  - directory mappings, active-profile state, and the background daemon/service");
+        console.log("  - app launchers it created in ~/Applications/Agent Switch");
         console.log("It does NOT touch your default claude/codex/antigravity installs.");
         console.log("\nRe-run with --force to proceed:  agent-switch uninstall --force");
         return;
@@ -1554,8 +1960,12 @@ function cmdUninstall(flags = {}) {
         if (credentials.removeEntry(configDir("claude", n)))
             removedEntries++;
     }
+    // Launchers live in ~/Applications, outside ROOT, and are listed in its manifest.
+    const removedLaunchers = removeAllLaunchers();
     fs.rmSync(ROOT, { recursive: true, force: true });
     console.log(`Removed ${allProfiles.length} profile(s) and all agent-switch data under ${ROOT}.`);
+    if (removedLaunchers > 0)
+        console.log(`Removed ${removedLaunchers} app launcher(s) from ~/Applications/Agent Switch.`);
     if (removedEntries > 0)
         console.log(`Removed ${removedEntries} Claude keychain entr(y/ies).`);
     console.log("Follow-ups (manual, if you set them up):");
@@ -1602,6 +2012,7 @@ function cmdApps(json = false) {
             provider: a.provider,
             strategy: a.strategy,
             installed: isInstalled(a),
+            copiesSettings: hasSettingsLayout(a.id),
         }));
         console.log(JSON.stringify(rows, null, 2));
         return;
@@ -1630,7 +2041,9 @@ function cmdNotify(flags) {
     }
     if (!title && !message)
         die("agent-switch notify needs at least --title or --message");
-    const created = appendNotification({ kind: kind, title, message });
+    // --repeat: each occurrence is its own moment (a session waiting again), so
+    // an identical notice is not collapsed into the last one.
+    const created = appendNotification({ kind: kind, title, message }, undefined, undefined, !flags.repeat);
     if (flags.json)
         console.log(JSON.stringify(created));
 }
@@ -1717,7 +2130,35 @@ async function cmdUpdate() {
         console.log(`Updating ${c.current} → ${c.release.tag} via npm…`);
     else
         console.log(`Update check failed (${c.message}); attempting \`npm install\` anyway…`);
-    process.exit(selfUpdate());
+    const code = selfUpdate();
+    logActivity("update", null, code === 0 ? "self-update installed" : `self-update failed (exit ${code})`, "user ran `agent-switch update`", code === 0);
+    if (code === 0)
+        await serviceAfterSelfUpdate();
+    process.exit(code);
+}
+/** Keeps the usage service on the version just installed. Without it the
+ *  balanced start has no fresh usage to weigh. */
+async function serviceAfterSelfUpdate() {
+    switch (serviceAfterUpdate(serviceTarget(), !!process.stdin.isTTY)) {
+        case "reinstall":
+            console.log("Restarting the background service on the new version…");
+            if (serviceInstallFromDisk() !== 0)
+                console.error("Couldn't restart the service — run `agent-switch service install`.");
+            return;
+        case "ask":
+            if (await confirmAction("Install the background service that keeps usage fresh (starts at login)?", false)) {
+                if (serviceInstallFromDisk() !== 0)
+                    console.error("Couldn't install the service — run `agent-switch service install`.");
+            }
+            else
+                console.log("Skipped. Install it any time with `agent-switch service install`.");
+            return;
+        case "hint":
+            console.log("Tip: `agent-switch service install` keeps usage fresh so starts can be balanced.");
+            return;
+        case "leave":
+            console.log("The background service runs another agent-switch build — left as it is.");
+    }
 }
 function cmdOpen(appId, name) {
     if (!appId)
@@ -1733,6 +2174,12 @@ function cmdOpen(appId, name) {
     requireProfile(app.provider, n, "open");
     if (!isInstalled(app))
         die(`${app.displayName} is not installed.`);
+    // A second launch on the same data dir would only hit the app's single-instance
+    // lock — bring the window that profile already has to the front instead.
+    if (app.strategy !== "env" && focusRunning(guiDataDir(app, n))) {
+        console.log(`${app.displayName} on ${app.provider}/${n} is already open — brought it to the front.`);
+        return;
+    }
     let firstLaunch = false;
     if (app.strategy === "user-data-dir") {
         const dir = guiDataDir(app, n);
@@ -1747,6 +2194,95 @@ function cmdOpen(appId, name) {
         console.log("is saved to this profile. Quit other windows of this app before signing in.");
     }
 }
+/** `agent-switch launcher add|remove <app> <profile>` · `list [--json]` · `repair`. */
+function cmdLauncher(sub, args, flags) {
+    const target = (verb) => {
+        const app = findApp(args[0] ?? "");
+        if (!app)
+            die(`usage: agent-switch launcher ${verb} <app> <profile>   (see \`agent-switch apps\`)`);
+        const n = requireProfile(app.provider, args[1], `launcher ${verb}`);
+        return { app, n };
+    };
+    switch (sub) {
+        case "add": {
+            const { app, n } = target("add");
+            try {
+                const e = createLauncher(app, n);
+                logActivity("launcher", `${app.provider}/${n}`, `created ${app.displayName} launcher`, "user ran `agent-switch launcher add`");
+                console.log(`Created ${e.path}`);
+                console.log("Start it from Spotlight or drag it into the Dock. It opens the app on this account only.");
+            }
+            catch (err) {
+                die(err instanceof Error ? err.message : String(err));
+            }
+            return;
+        }
+        case "remove":
+        case "rm": {
+            const { app, n } = target("remove");
+            if (!removeLauncher(app.id, n))
+                die(`no ${app.displayName} launcher for ${app.provider}/${n}.`);
+            logActivity("launcher", `${app.provider}/${n}`, `removed ${app.displayName} launcher`, "user ran `agent-switch launcher remove`");
+            console.log(`Removed the ${app.displayName} launcher for ${app.provider}/${n}.`);
+            return;
+        }
+        case "repair": {
+            const r = repairLaunchers();
+            for (const e of r.rebuilt)
+                console.log(`Rebuilt ${e.path}`);
+            for (const f of r.failed)
+                console.error(`Couldn't rebuild ${f.entry.path}: ${f.reason}`);
+            if (!r.rebuilt.length && !r.failed.length)
+                console.log("No launchers to repair.");
+            if (r.failed.length)
+                process.exit(1);
+            return;
+        }
+        case "list":
+        case undefined: {
+            const rows = readLaunchers().map((e) => ({ ...e, exists: fs.existsSync(e.path) }));
+            if (flags.json)
+                return void console.log(JSON.stringify(rows, null, 2));
+            if (!rows.length)
+                return void console.log("No launchers. Create one with `agent-switch launcher add <app> <profile>`.");
+            for (const r of rows)
+                console.log(`${r.exists ? "●" : "○ missing"} ${r.app.padEnd(16)} ${r.provider}/${r.profile}  ${r.path}`);
+            return;
+        }
+        default:
+            die("usage: agent-switch launcher add|remove <app> <profile> | list [--json] | repair");
+    }
+}
+/** `agent-switch app-settings copy <app> --from <profile|default> --to <profile>`. */
+function cmdAppSettings(sub, args, flags) {
+    const app = findApp(args[0] ?? "");
+    const from = typeof flags.from === "string" ? flags.from : null;
+    const to = typeof flags.to === "string" ? flags.to : null;
+    if (sub !== "copy" || !app || !from || !to)
+        die("usage: agent-switch app-settings copy <app> --from <profile|default> --to <profile>");
+    if (!hasSettingsLayout(app.id))
+        die(`copying settings is not supported for ${app.displayName}.`);
+    if (from === to)
+        die("--from and --to are the same profile.");
+    const toProfile = requireProfile(app.provider, to, "app-settings copy");
+    const fromDir = from === "default" ? DEFAULT_DATA_DIR[app.id] : guiDataDir(app, requireProfile(app.provider, from, "app-settings copy"));
+    const toDir = guiDataDir(app, toProfile);
+    if (!fs.existsSync(fromDir))
+        die(`${from === "default" ? `The default ${app.displayName}` : `${app.provider}/${from}`} has no ${app.displayName} data yet.`);
+    // The running app rewrites its own files on quit and would undo the copy.
+    if (findRunning(toDir))
+        die(`${app.displayName} is open on ${app.provider}/${toProfile} — quit it first, then copy.`);
+    const r = copyDesktopSettings(app.id, fromDir, toDir);
+    logActivity("settings", `${app.provider}/${toProfile}`, `copied ${app.displayName} settings from ${from}`, "user ran `agent-switch app-settings copy`");
+    if (flags.json)
+        return void console.log(JSON.stringify({ app: app.id, from, to: toProfile, ...r }, null, 2));
+    if (!r.copied.length)
+        return void console.log(`Nothing to copy — ${from} has no ${app.displayName} settings yet.`);
+    console.log(`Copied ${r.copied.join(", ")} from ${from} to ${app.provider}/${toProfile}.`);
+    if (r.backups.length)
+        console.log(`Previous files kept as ${r.backups.map((b) => path.basename(b)).join(", ")}.`);
+    console.log("Logins, chats and account-bound preferences were not copied.");
+}
 /**
  * `agent-switch guard [block|warn|off]` — read or set the single-load policy.
  * The bare form also reports what is loaded RIGHT NOW, because "what is my
@@ -1758,6 +2294,7 @@ function cmdGuard(value, json = false) {
             die(`unknown guard policy "${value}" (choose: ${GUARD_POLICIES.join(", ")})`);
         }
         setGuard(value);
+        logActivity("guard", null, `set ${value}`, "user ran `agent-switch guard`");
     }
     const policy = readGuard();
     // Every profile of every provider that can report a live session.
@@ -1804,8 +2341,17 @@ function cmdGuard(value, json = false) {
         console.log(`Override once: ${OVERRIDE_ENV}=1 <binary>    ·    Change: agent-switch guard <${GUARD_POLICIES.join("|")}>`);
     }
 }
-function cmdShellenv(shellArg) {
-    console.log(shellenvScript(detectShell(shellArg)));
+function cmdShellenv(shellArg, sub, json = false) {
+    if (sub !== "install")
+        return void console.log(shellenvScript(detectShell(shellArg)));
+    const shell = detectShell(shellArg);
+    const present = shellIntegrationCheck(HOME).status === "ok";
+    const r = installShellIntegration(shell, HOME, present);
+    if (json)
+        return void console.log(JSON.stringify(r));
+    console.log(r.alreadyInstalled
+        ? "The shell integration is already installed."
+        : `Added the shell integration to ${r.file}. Open a new terminal (or run: source ${r.file}) and \`${shell === "powershell" ? "claude" : "type claude"}\` uses agent-switch.`);
 }
 /** `agent-switch tooling` — ecosystem tool readout (agent-config, rtk, provider
  *  CLIs). `--json` is the GUI IPC contract: the GUI renders this readout and
@@ -1922,8 +2468,11 @@ function usage() {
 Provider defaults to claude; pass --provider codex|antigravity for the others.
 Run with no command to launch the tray/menubar GUI (single-instance).
 
-  agent-switch add [--provider P] <name>       create a profile and log it in
+  agent-switch add [--provider P] <name> [--browser B]   create a profile and sign it in
+  agent-switch login [--provider P] <name> [--browser <id>]   sign an existing profile in again (after a sign-out / expired login); --browser opens the Claude sign-in in that browser
+  agent-switch browsers [--json]               browsers --browser can open (macOS / Linux)
   agent-switch import [--provider P] <name>    migrate the default install (no re-login)
+  agent-switch mark-shared [--provider P] <name> [--off]   mark a profile as sharing the default install's login (never refreshed or balanced)
   agent-switch use [--provider P] <name>       set the active profile for a provider
   agent-switch deactivate [--provider P]       clear the active profile for a provider
   agent-switch run [--provider P] <name> [--tmux] [..]  launch the provider's CLI (--tmux = managed tmux session, POSIX)
@@ -1931,9 +2480,10 @@ Run with no command to launch the tray/menubar GUI (single-instance).
   agent-switch status [--provider P] [name] [--json]   identity (+ Claude usage); --json = active only
   agent-switch current [--provider P]          show the active profile(s)
   agent-switch whoami [--provider P] [name]    show a profile's account identity
-  agent-switch dir [--provider P] [--guard]    resolve profile for CWD (mapping > active)
-  agent-switch guard [block|warn|off]          one profile, one live session (default block)
-  agent-switch map [--provider P] <name> [dir] map a directory to a profile
+  agent-switch dir [--provider P] [--guard] [--json] [--plain]   resolve profile for CWD (rule > balanced pick > active); --json adds why
+  agent-switch guard [block|warn|off]          one profile, one live session (default warn on new installs)
+  agent-switch map [--provider P] <name|pool:<id>> [dir]   map a directory to a profile or a pool
+  agent-switch map --pause|--resume [--provider P] [dir]   pause a folder rule (kept, but skipped) or turn it back on
   agent-switch unmap [--provider P] [dir]      remove a directory mapping
   agent-switch mappings                        list directory mappings
   agent-switch share on|sync|off|status [--history] [--source <profile|default>] [--json]   (Claude)
@@ -1945,18 +2495,29 @@ Run with no command to launch the tray/menubar GUI (single-instance).
   agent-switch takeover <id> --to <profile> [--from <profile>] [--keep-source] [--in-place] [--print-only] [--force]   move a session to another profile and resume it
   agent-switch rebind [<account>] [--profile <p>]   |   rebind --restore [--profile <p>]   |   rebind --reset   switch a RUNNING profile's account (macOS; no <account> = interactive picker; --restore reverses; --reset re-enables after a circuit-breaker trip)
   agent-switch web <name>                      claude.ai in a persistent browser (Claude)
-  agent-switch remove [--provider P] <name> [--force]   delete a profile
+  agent-switch remove [--provider P] <name> [--force] [--yes]   delete a profile (asks on a terminal; --yes skips)
   agent-switch label [--provider P] <name> [Work|Personal|Other|none]   tag a profile
+  agent-switch desktop [--json]                which accounts ran sessions in each Claude Desktop instance
+  agent-switch activate [--json]               make this CLI the one terminals and the background service use
+  agent-switch disable|enable [--provider P] <name>   keep a profile but stop using it / turn it back on
+  agent-switch color [--provider P] <name> [orange|red|yellow|green|teal|blue|purple|pink|none]   pick a profile's colour
   agent-switch autoswitch on|off|status [--provider P] [--threshold <1-100>]   notify + suggest near a usage limit; never switches automatically (default OFF)
-  agent-switch reset <profile> --provider codex                                redeem one banked Codex rate-limit reset
+  agent-switch reset <profile> --provider codex [--yes]                        redeem one banked Codex rate-limit reset (asks on a terminal)
+  agent-switch protection [--json] | protection set <provider/name> [--on|--off] [--threshold N]   per-profile limit warning (default on, 98%)
+  agent-switch pool [list|create|rename|delete|add|remove|suggest] [--json]    optional groups a folder rule can point at
+  agent-switch auth-status [--provider P] [--json]   per-profile login state from the provider's store (no tokens)
+  agent-switch activity [--limit N] [--json]   what agent-switch itself did, and why
   agent-switch rename <old> <new> [--provider P]                               rename a profile (name & keep its tag)
   agent-switch providers enable|disable|status [--provider P] [--surface cli|ui]   enable/disable a provider (default: Claude + Codex)
   agent-switch [gui]                           launch the tray/menubar GUI (the default with no command; won't start a second if one is running)
   agent-switch check-update [--json]           check GitHub Releases for a newer version
-  agent-switch update                          self-update to the latest version (via npm)
+  agent-switch update                          self-update to the latest version (via npm); restarts the service on it, or offers to install one
   agent-switch apps                            list launchable GUI apps (macOS)
-  agent-switch open <app> [profile]            launch a GUI app on a profile, isolated (macOS)
+  agent-switch open <app> [profile]            launch a GUI app on a profile, isolated; focuses it if already open (macOS)
+  agent-switch launcher add|remove <app> <profile> | list [--json] | repair   Dock/Spotlight launcher per account in ~/Applications/Agent Switch (macOS)
+  agent-switch app-settings copy <app> --from <profile|default> --to <profile> [--json]   copy desktop settings (MCP, preferences, extensions) — never logins
   agent-switch shellenv [--shell zsh|bash|fish|powershell]   shell integration
+  agent-switch shellenv install [--shell S] [--json]   add it to your shell's startup file
   agent-switch service run|start|stop|status|install|uninstall   background usage daemon
   agent-switch notifications [clear] [--json]  recent notifications (usage-limit suggestions, fetch failures)
   agent-switch notify --kind K --title T --message M [--json]   record a notification event
@@ -1966,7 +2527,7 @@ Run with no command to launch the tray/menubar GUI (single-instance).
   agent-switch tooling [--json]                ecosystem tool readout (agent-config, rtk, provider CLIs)
   agent-switch tooling install|upgrade <tool>  install/upgrade an ecosystem tool (agent-config, rtk, claude, codex)
   agent-switch tooling notes [<tool>] [--latest] [--json]   read an ecosystem tool's release notes (default agent-config; fetches from GitHub)
-  agent-switch doctor                          per-OS, per-provider self-check`);
+  agent-switch doctor [--json]                  per-OS, per-provider self-check`);
 }
 /**
  * The interactive limit dialog (Phase 4) — `agent-switch rebind` with no account
@@ -2039,6 +2600,7 @@ async function rebindDialog(running) {
     }
     try {
         const r = await rebind({ account: choice.profile, profile: running });
+        logActivity("rebind", `claude/${running}`, `now serves ${choice.profile}'s account`, "user picked it in the rebind dialog");
         console.log(r.uxNote);
     }
     catch (e) {
@@ -2088,6 +2650,7 @@ async function cmdRebind(providerId, providerExplicit, account, flags) {
         requireProfile("claude", profile, "rebind --restore --profile");
         try {
             const r = await restoreRebind({ profile });
+            logActivity("rebind", `claude/${profile}`, `restored own account (was on ${r.wasBoundTo})`, "user ran `agent-switch rebind --restore`");
             console.log(`Restored "${r.restoredProfile}" to its own account (was rebound to "${r.wasBoundTo}").`);
         }
         catch (e) {
@@ -2110,12 +2673,233 @@ async function cmdRebind(providerId, providerExplicit, account, flags) {
     requireProfile("claude", profile, "rebind --profile");
     try {
         const r = await rebind({ account, profile });
+        logActivity("rebind", `claude/${profile}`, `now serves ${account}'s account`, "user ran `agent-switch rebind`");
         console.log(r.uxNote);
     }
     catch (e) {
         die(e.message);
     }
 }
+// ---------- gui-settings / activity / auth-status / protection / pool ----------
+/** `gui-settings [--json]` · `gui-settings set pet-welcomed` ·
+ *  `gui-settings set autostart enabled|disabled --by first-run|user` ·
+ *  `gui-settings set autostart-degraded --reason <text>|none`. The GUI's
+ *  file-backed preferences (see gui-settings.ts); prints the result as JSON. */
+function cmdGuiSettings(sub, args, flags) {
+    const usageLine = "usage: agent-switch gui-settings [--json] | gui-settings set pet-welcomed | set autostart enabled|disabled --by first-run|user | set autostart-degraded --reason <text>|none";
+    if (sub === undefined || sub === "get" || sub === "status") {
+        console.log(JSON.stringify(readGuiSettings(), null, 2));
+        return;
+    }
+    if (sub !== "set")
+        die(usageLine);
+    const [key, value] = args;
+    let u;
+    if (key === "pet-welcomed")
+        u = { key };
+    else if (key === "autostart" && (value === "enabled" || value === "disabled")) {
+        const by = flags.by === "first-run" || flags.by === "user" ? flags.by : die(usageLine);
+        u = { key, state: value, by };
+    }
+    else if (key === "autostart-degraded") {
+        const reason = typeof flags.reason === "string" ? flags.reason : die(usageLine);
+        u = { key, reason: reason === "none" ? null : reason };
+    }
+    else
+        die(usageLine);
+    const before = readGuiSettings();
+    let after;
+    try {
+        after = applyGuiSetting(before, u);
+    }
+    catch (e) {
+        die(e.message);
+    }
+    writeGuiSettings(after);
+    if (u.key === "autostart" && JSON.stringify(after.autostart) !== JSON.stringify(before.autostart)) {
+        logActivity("autostart", null, `start at login ${u.state}`, u.by === "user" ? "user changed it in the desktop app" : "first-run default, confirmed with the OS");
+    }
+    if (u.key === "autostart-degraded" && u.reason) {
+        logActivity("autostart", null, "start at login could not be confirmed", "first-run default; retried next launch", false);
+    }
+    console.log(JSON.stringify(after, null, 2));
+}
+function cmdActivity(flags) {
+    const limit = typeof flags.limit === "string" ? Number(flags.limit) : undefined;
+    if (limit !== undefined && (!Number.isInteger(limit) || limit < 1))
+        die("--limit must be a whole number of at least 1");
+    const entries = readActivity(limit ?? (flags.json ? undefined : 50));
+    if (flags.json) {
+        console.log(JSON.stringify({ entries, capacity: ACTIVITY_MAX_LINES }, null, 2));
+        return;
+    }
+    if (entries.length === 0) {
+        console.log("No activity recorded yet.");
+        return;
+    }
+    for (const e of entries) {
+        console.log(`${e.at}  ${e.ok ? " " : "!"} ${e.kind.padEnd(10)} ${e.target ?? "-"}  ${e.action} — ${e.reason}`);
+    }
+}
+function authStatusFor(providerId, name) {
+    const s = rawAuthStatusFor(providerId, name);
+    const keptFreshBy = keptFreshByFor(providerId, { shared: sharesDefaultLogin(providerId, name), serviceInstalled: serviceTarget() !== "not-installed" }, s.keptFreshBy);
+    return { ...s, keptFreshBy };
+}
+function rawAuthStatusFor(providerId, name) {
+    const now = Date.now();
+    const cfg = provider(providerId).configDirFor(configDir(providerId, name));
+    if (providerId === "claude") {
+        const file = claudeCredentialFile(cfg);
+        const fromFile = readText(file);
+        return claudeAuthStatus(name, credentials.read(cfg), fromFile !== null ? fileMtimeMs(file) : null, now);
+    }
+    if (providerId === "codex")
+        return codexAuthStatus(name, readText(provider("codex").credentialPath(cfg)), now);
+    return antigravityAuthStatus(name, fs.existsSync(provider("antigravity").credentialPath(cfg)));
+}
+function cmdAuthStatus(providerId, json) {
+    const rows = (providerId ? listProfiles(providerId).map((n) => ({ provider: providerId, name: n })) : listAllProfiles()).map((r) => authStatusFor(r.provider, r.name));
+    if (json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    if (rows.length === 0)
+        return void console.log("No profiles.");
+    for (const r of rows) {
+        const exp = r.expiresAt ? `, ends ${r.expiresAt}` : "";
+        console.log(`${`${r.provider}/${r.name}`.padEnd(24)} ${r.state}${exp} — ${r.detail}`);
+    }
+}
+function parseMemberArg(v, usageLine) {
+    const m = v ? parseMember(v) : null;
+    if (!m)
+        die(usageLine);
+    return m;
+}
+function cmdProtection(sub, args, flags) {
+    const usageLine = "usage: agent-switch protection [--json] | protection set <provider/name> [--on|--off] [--threshold <1-100>]";
+    if (sub === undefined || sub === "status" || sub === "list") {
+        const rows = listAllProfiles().map((p) => ({ profile: `${p.provider}/${p.name}`, ...readProtection(p.provider, p.name) }));
+        if (flags.json)
+            return void console.log(JSON.stringify(rows, null, 2));
+        if (rows.length === 0)
+            return void console.log("No profiles.");
+        for (const r of rows)
+            console.log(`${r.profile.padEnd(24)} ${r.enabled ? "on " : "off"}  at ${r.thresholdPct}%`);
+        console.log("\nA warning when a profile reaches its threshold — nothing is paused or switched.");
+        return;
+    }
+    if (sub !== "set")
+        die(usageLine);
+    const m = parseMemberArg(args[0], usageLine);
+    requireProfile(m.provider, m.name, "protection set");
+    if (flags.on && flags.off)
+        die("pass either --on or --off, not both");
+    const threshold = typeof flags.threshold === "string" ? Number(flags.threshold) : undefined;
+    if (threshold !== undefined && !(Number.isInteger(threshold) && threshold >= 1 && threshold <= 100))
+        die("--threshold must be a whole number between 1 and 100");
+    if (!flags.on && !flags.off && threshold === undefined)
+        die(usageLine);
+    const next = setProtection(m.provider, m.name, {
+        ...(flags.on ? { enabled: true } : {}),
+        ...(flags.off ? { enabled: false } : {}),
+        ...(threshold !== undefined ? { thresholdPct: threshold } : {}),
+    });
+    logActivity("protection", `${m.provider}/${m.name}`, `${next.enabled ? "on" : "off"} at ${next.thresholdPct}%`, "user ran `agent-switch protection set`");
+    if (flags.json)
+        return void console.log(JSON.stringify({ profile: `${m.provider}/${m.name}`, ...next }, null, 2));
+    console.log(`Session protection for ${m.provider}/${m.name}: ${next.enabled ? "on" : "off"} at ${next.thresholdPct}%.`);
+}
+function poolMappings(id) {
+    return mappingRows().filter((r) => r.name === `${POOL_PREFIX}${id}`).map((r) => `${r.path} (${r.provider})`);
+}
+function cmdPool(sub, args, flags) {
+    const usageLine = "usage: agent-switch pool [list] [--json] | pool create <name> | pool rename <id> <name> | pool delete <id> | pool add <id> <provider/name> | pool remove <id> <provider/name> | pool suggest [--confirm] [--json]";
+    const json = !!flags.json;
+    const out = (v, text) => console.log(json ? JSON.stringify(v, null, 2) : text);
+    try {
+        switch (sub) {
+            case undefined:
+            case "list": {
+                const pools = readPools().map((p) => ({ ...p, rules: poolMappings(p.id) }));
+                if (json)
+                    return void console.log(JSON.stringify(pools, null, 2));
+                if (pools.length === 0)
+                    return void console.log("No pools. Pools are optional — create one with: agent-switch pool create <name>");
+                for (const p of pools) {
+                    console.log(`${p.id}  "${p.name}"  ${p.members.length ? p.members.join(", ") : "(no members)"}${p.rules.length ? `  · folders: ${p.rules.join(", ")}` : ""}`);
+                }
+                return;
+            }
+            case "create": {
+                if (!args[0])
+                    die(usageLine);
+                const p = createPool(args.join(" "));
+                logActivity("pool", p.id, "created", "user ran `agent-switch pool create`");
+                return out(p, `Created pool ${p.id} ("${p.name}"). Add members: agent-switch pool add ${p.id} <provider/name>`);
+            }
+            case "rename": {
+                if (!args[0] || !args[1])
+                    die(usageLine);
+                const p = renamePool(args[0], args.slice(1).join(" "));
+                logActivity("pool", p.id, `renamed to "${p.name}"`, "user ran `agent-switch pool rename`");
+                return out(p, `Pool ${p.id} is now called "${p.name}" (its id and folder rules are unchanged).`);
+            }
+            case "delete": {
+                if (!args[0])
+                    die(usageLine);
+                const rules = poolMappings(args[0]);
+                if (rules.length > 0)
+                    die(`pool "${args[0]}" is used by folder rules: ${rules.join(", ")}. Remove them first (agent-switch unmap <dir>).`);
+                deletePool(args[0]);
+                logActivity("pool", args[0], "deleted", "user ran `agent-switch pool delete`");
+                return out({ deleted: args[0] }, `Deleted pool ${args[0]}. Its profiles are untouched.`);
+            }
+            case "add":
+            case "remove": {
+                if (!args[0])
+                    die(usageLine);
+                const m = parseMemberArg(args[1], usageLine);
+                if (sub === "add")
+                    requireProfile(m.provider, m.name, "pool add");
+                const key = `${m.provider}/${m.name}`;
+                const p = sub === "add" ? addPoolMember(args[0], key) : removePoolMember(args[0], key);
+                logActivity("pool", p.id, `${sub === "add" ? "added" : "removed"} ${key}`, `user ran \`agent-switch pool ${sub}\``);
+                return out(p, `${sub === "add" ? "Added" : "Removed"} ${key} ${sub === "add" ? "to" : "from"} pool ${p.id}.`);
+            }
+            case "suggest": {
+                const proposals = suggestPoolsFromLabels();
+                if (!flags.confirm) {
+                    if (json)
+                        return void console.log(JSON.stringify({ preview: true, proposals }, null, 2));
+                    if (proposals.length === 0)
+                        return void console.log("No labelled profiles — nothing to suggest.");
+                    console.log("Preview — nothing is created until you run `agent-switch pool suggest --confirm`:");
+                    for (const p of proposals)
+                        console.log(`  ${p.id}  ${p.members.join(", ")}${p.exists ? "  (exists — skipped)" : ""}`);
+                    return;
+                }
+                const created = [];
+                for (const prop of proposals) {
+                    if (prop.exists)
+                        continue;
+                    const pool = createPool(prop.name);
+                    for (const m of prop.members)
+                        addPoolMember(pool.id, m);
+                    created.push(pool.id);
+                    logActivity("pool", pool.id, `created from label ${prop.name}`, "user confirmed `agent-switch pool suggest`");
+                }
+                return out({ created }, created.length ? `Created pools: ${created.join(", ")}.` : "Nothing to create.");
+            }
+            default:
+                die(usageLine);
+        }
+    }
+    catch (e) {
+        die(e.message);
+    }
+}
 // ---------- main -------------------------------------------------------------
 async function main() {
     const argv = process.argv.slice(2);
@@ -2144,13 +2928,22 @@ async function main() {
         }
     }
     switch (cmd) {
-        case "add": return cmdAdd(providerId, positional[0]);
+        case "add": return cmdAdd(providerId, positional[0], typeof flags.browser === "string" ? flags.browser : undefined);
+        case "login": return cmdLogin(providerId, positional[0], typeof flags.browser === "string" ? flags.browser : undefined);
+        case "browsers": return cmdBrowsers(!!flags.json);
         case "import": return cmdImport(providerId, positional[0]);
         case "use": return cmdUse(providerId, positional[0]);
         case "deactivate": return cmdDeactivate(providerId);
         case "label": return cmdLabel(providerId, positional[0], positional[1]);
+        case "color":
+        case "colour": return cmdColor(providerId, positional[0], positional[1]);
+        case "activate": return cmdActivate(!!flags.json);
+        case "desktop": return cmdDesktop(!!flags.json);
+        case "disable": return cmdDisable(providerId, positional[0], true);
+        case "enable": return cmdDisable(providerId, positional[0], false);
+        case "mark-shared": return cmdMarkShared(providerId, positional[0], !!flags.off);
         case "autoswitch": return cmdAutoswitch(providerId, providerExplicit, positional[0], flags);
-        case "reset": return cmdReset(providerId, positional[0]);
+        case "reset": return cmdReset(providerId, positional[0], !!flags.yes);
         case "rename": return cmdRename(providerId, positional[0], positional[1]);
         case "providers": return cmdProviders(providerId, providerExplicit, positional[0], flags);
         case "gui": return cmdGui();
@@ -2159,14 +2952,23 @@ async function main() {
         case "check-update":
         case "check-updates": return cmdCheckUpdate(!!flags.json);
         case "open": return cmdOpen(positional[0], positional[1]);
+        case "launcher":
+        case "launchers": return cmdLauncher(positional[0], positional.slice(1), flags);
+        case "app-settings": return cmdAppSettings(positional[0], positional.slice(1), flags);
         case "apps": return cmdApps(!!flags.json);
         case "notify": return cmdNotify(flags);
         case "notifications": return cmdNotifications(positional[0], !!flags.json);
         case "os-notify": return cmdOsNotify(positional[0], !!flags.json);
         case "uninstall": return cmdUninstall(flags);
         case "run": {
-            const r = parseRun(rest);
-            return cmdRun(r.providerId, r.name, r.args);
+            let r;
+            try {
+                r = parseRun(rest);
+            }
+            catch (e) {
+                die(e.message);
+            }
+            return cmdRun(r.providerId, r.name, r.args, r.cwd);
         }
         case "handoff": return cmdHandoff(providerId, positional[0], positional.slice(1), flags);
         case "list":
@@ -2174,11 +2976,11 @@ async function main() {
         case "status": return cmdStatus(providerExplicit ? providerId : undefined, positional[0], !!flags.json);
         case "current": return cmdCurrent(providerExplicit ? providerId : undefined);
         case "whoami": return cmdWhoami(providerId, positional[0]);
-        case "dir": return cmdDir(providerId, !!flags.guard);
+        case "dir": return cmdDir(providerId, !!flags.guard, !!flags.json, !!flags.plain);
         case "guard": return cmdGuard(positional[0], !!flags.json);
-        case "map": return cmdMap(providerId, positional[0], positional[1]);
+        case "map": return cmdMap(providerId, positional[0], positional[1], flags);
         case "unmap": return cmdUnmap(providerExplicit ? providerId : undefined, positional[0]);
-        case "mappings": return cmdMappings();
+        case "mappings": return cmdMappings(rest.includes("--json"));
         case "share": return cmdShare(positional[0], rest.slice(1));
         case "config": return cmdConfig(positional[0], positional[1], flags);
         case "sessions":
@@ -2196,8 +2998,11 @@ async function main() {
         case "rebind": return cmdRebind(providerId, providerExplicit, positional[0], flags);
         case "web": return cmdWeb(positional[0]);
         case "remove":
-        case "rm": return cmdRemove(providerId, positional[0], !!flags.force);
-        case "shellenv": return cmdShellenv(flags.shell ?? positional[0]);
+        case "rm": return cmdRemove(providerId, positional[0], !!flags.force, !!flags.yes);
+        case "shellenv":
+            return positional[0] === "install"
+                ? cmdShellenv(flags.shell, "install", !!flags.json)
+                : cmdShellenv(flags.shell ?? positional[0]);
         case "service": return cmdService(positional[0]);
         case "usage": return cmdUsageHistory(providerId, positional[0], flags);
         case "tooling":
@@ -2210,7 +3015,13 @@ async function main() {
                 die(`usage: agent-switch tooling [install|upgrade <${TOOL_IDS.join("|")}>] [notes [<tool>]] [--json]`);
             }
             return cmdTooling(!!flags.json);
-        case "doctor": return process.exit(await runDoctor());
+        case "doctor": return process.exit(await runDoctor(!!flags.json));
+        case "auth-status": return cmdAuthStatus(providerExplicit ? providerId : undefined, !!flags.json);
+        case "activity": return cmdActivity(flags);
+        case "protection": return cmdProtection(positional[0], positional.slice(1), flags);
+        case "pool":
+        case "pools": return cmdPool(positional[0], positional.slice(1), flags);
+        case "gui-settings": return cmdGuiSettings(positional[0], positional.slice(1), flags);
         case "help":
         case "--help":
         case "-h": return usage();