agent-yes 1.118.0 → 1.118.2

package/dist/SUPPORTED_CLIS-Bq_fBaXd.js

@@ -0,0 +1,8 @@
+import "./ts-BUpRpKjH.js";
+import "./logger-B9h0djqx.js";
+import "./versionChecker-D-drPifS.js";
+import "./pidStore-B5vBu8Px.js";
+import "./globalPidIndex-gZuTvTBs.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CNLy57hz.js";
+
+export { SUPPORTED_CLIS };

package/dist/{SUPPORTED_CLIS-CrIGjD28.js → SUPPORTED_CLIS-CNLy57hz.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-DYzATaI_.js";
+import { t as CLIS_CONFIG } from "./ts-BUpRpKjH.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-CrIGjD28.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-CNLy57hz.js.map

package/dist/{agent-yes.config-1LMoK18R.js → agent-yes.config-kmtJKJHk.js}

@@ -288,4 +288,4 @@ async function getDefaultConfig() {
 
 //#endregion
 export { agent_yes_config_default as default };
-//# sourceMappingURL=agent-yes.config-1LMoK18R.js.map
+//# sourceMappingURL=agent-yes.config-kmtJKJHk.js.map

package/dist/agentYesHome-BvaUOzCV.js

@@ -0,0 +1,25 @@
+import { homedir } from "os";
+import path from "path";
+
+//#region ts/agentYesHome.ts
+/**
+* Root directory for cross-runtime, machine-global agent-yes state:
+* the pid index (`pids.jsonl`), FIFO/named-pipe IPC endpoints (`fifo/`),
+* winsize signals, notes, and the serve token.
+*
+* Durable per-session *logs* deliberately do NOT live here — they go under
+* `<cwd>/.agent-yes/` so they stay colocated with the project that produced
+* them (see `PidStore`). Only ephemeral IPC + the discovery index are global,
+* which keeps FIFOs on the local home filesystem (reliable `mkfifo`) and lets
+* `ay ls`/`ay attach` find every agent regardless of the caller's cwd.
+*
+* Resolved at call time (not module load) so tests and callers can override
+* via `$AGENT_YES_HOME` without juggling the module cache.
+*/
+function agentYesHome() {
+	return process.env.AGENT_YES_HOME ?? path.join(homedir(), ".agent-yes");
+}
+
+//#endregion
+export { agentYesHome as t };
+//# sourceMappingURL=agentYesHome-BvaUOzCV.js.map

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { n as logger } from "./logger-B9h0djqx.js";
-import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-D-OYziVA.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-D-drPifS.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -482,7 +482,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 {
 	const rawArg = process.argv[2];
 	const isHelpFlag = rawArg === "-h" || rawArg === "--help";
-	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-FtwGxxtc.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-CIrlUP1E.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp();
 		process.exit(0);
@@ -496,12 +496,12 @@ await checkAndAutoUpdate();
 logger.info(versionString());
 const config = parseCliArgs(process.argv);
 if (config.tray) {
-	const { startTray } = await import("./tray-CWQe9DMY.js");
+	const { startTray } = await import("./tray-B8_rx1iu.js");
 	await startTray();
 	await new Promise(() => {});
 }
 {
-	const { ensureTray } = await import("./tray-CWQe9DMY.js");
+	const { ensureTray } = await import("./tray-B8_rx1iu.js");
 	ensureTray();
 }
 if (config.useRust) {
@@ -515,7 +515,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-BS7EiXxW.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-Bq_fBaXd.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);
@@ -545,7 +545,7 @@ if (config.showVersion) {
 	process.exit(0);
 }
 if (config.appendPrompt) {
-	const { PidStore } = await import("./pidStore-BLcnCpkX.js");
+	const { PidStore } = await import("./pidStore-7y1cTcAE.js");
 	const ipcPath = await PidStore.findActiveFifo(process.cwd());
 	if (!ipcPath) {
 		console.error("No active agent with IPC found in current directory.");

package/dist/{globalPidIndex-yVd3mbsV.js → globalPidIndex-gZuTvTBs.js}

@@ -189,4 +189,4 @@ async function pruneOldLogs(maxAgeMs = retentionMs()) {
 
 //#endregion
 export { updateGlobalPidStatus as a, readGlobalPids as i, maybeCompactGlobalPids as n, pruneOldLogs as r, appendGlobalPid as t };
-//# sourceMappingURL=globalPidIndex-yVd3mbsV.js.map
+//# sourceMappingURL=globalPidIndex-gZuTvTBs.js.map

package/dist/index.js

@@ -1,7 +1,7 @@
-import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-DYzATaI_.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-BUpRpKjH.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-D-OYziVA.js";
-import "./pidStore-BcGnnKQf.js";
-import "./globalPidIndex-yVd3mbsV.js";
+import "./versionChecker-D-drPifS.js";
+import "./pidStore-B5vBu8Px.js";
+import "./globalPidIndex-gZuTvTBs.js";
 
 export { AgentContext, CLIS_CONFIG, config, agentYes as default, removeControlCharacters };

package/dist/pidStore-7y1cTcAE.js

@@ -0,0 +1,5 @@
+import "./logger-B9h0djqx.js";
+import { t as PidStore } from "./pidStore-B5vBu8Px.js";
+import "./globalPidIndex-gZuTvTBs.js";
+
+export { PidStore };

package/dist/{pidStore-BcGnnKQf.js → pidStore-B5vBu8Px.js}

@@ -1,31 +1,11 @@
 import { n as logger } from "./logger-B9h0djqx.js";
-import { a as updateGlobalPidStatus, n as maybeCompactGlobalPids, r as pruneOldLogs, t as appendGlobalPid } from "./globalPidIndex-yVd3mbsV.js";
+import { t as agentYesHome } from "./agentYesHome-BvaUOzCV.js";
+import { a as updateGlobalPidStatus, n as maybeCompactGlobalPids, r as pruneOldLogs, t as appendGlobalPid } from "./globalPidIndex-gZuTvTBs.js";
 import { closeSync, existsSync, fsyncSync, openSync } from "fs";
 import { appendFile, mkdir, readFile, rename, writeFile } from "fs/promises";
-import { homedir } from "os";
 import path from "path";
 import { lock } from "proper-lockfile";
 
-//#region ts/agentYesHome.ts
-/**
-* Root directory for cross-runtime, machine-global agent-yes state:
-* the pid index (`pids.jsonl`), FIFO/named-pipe IPC endpoints (`fifo/`),
-* winsize signals, notes, and the serve token.
-*
-* Durable per-session *logs* deliberately do NOT live here — they go under
-* `<cwd>/.agent-yes/` so they stay colocated with the project that produced
-* them (see `PidStore`). Only ephemeral IPC + the discovery index are global,
-* which keeps FIFOs on the local home filesystem (reliable `mkfifo`) and lets
-* `ay ls`/`ay attach` find every agent regardless of the caller's cwd.
-*
-* Resolved at call time (not module load) so tests and callers can override
-* via `$AGENT_YES_HOME` without juggling the module cache.
-*/
-function agentYesHome() {
-	return process.env.AGENT_YES_HOME ?? path.join(homedir(), ".agent-yes");
-}
-
-//#endregion
 //#region ts/JsonlStore.ts
 /**
 * A lightweight NeDB-style JSONL persistence layer.
@@ -381,5 +361,5 @@ pid-db/
 };
 
 //#endregion
-export { agentYesHome as n, PidStore as t };
-//# sourceMappingURL=pidStore-BcGnnKQf.js.map
+export { PidStore as t };
+//# sourceMappingURL=pidStore-B5vBu8Px.js.map

package/dist/{remotes-C3xPRtfg.js → remotes-BufkGk0e.js}

@@ -147,4 +147,4 @@ async function cmdRemote(rest) {
 
 //#endregion
 export { resolveRemoteSpec as a, readRemotes as i, deleteRemoteAlias as n, writeRemoteAlias as o, parseDirectRemoteSpec as r, cmdRemote as t };
-//# sourceMappingURL=remotes-C3xPRtfg.js.map
+//# sourceMappingURL=remotes-BufkGk0e.js.map

package/dist/{remotes-C9WMt5PY.js → remotes-DavR4Hca.js}

@@ -1,3 +1,3 @@
-import { a as resolveRemoteSpec, i as readRemotes, n as deleteRemoteAlias, o as writeRemoteAlias, r as parseDirectRemoteSpec, t as cmdRemote } from "./remotes-C3xPRtfg.js";
+import { a as resolveRemoteSpec, i as readRemotes, n as deleteRemoteAlias, o as writeRemoteAlias, r as parseDirectRemoteSpec, t as cmdRemote } from "./remotes-BufkGk0e.js";
 
 export { cmdRemote };

package/dist/{serve-uhfwjvBd.js → serve-DKpVuQyU.js}

@@ -1,11 +1,11 @@
-import "./ts-DYzATaI_.js";
+import "./ts-BUpRpKjH.js";
 import "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-D-OYziVA.js";
-import "./pidStore-BcGnnKQf.js";
-import "./globalPidIndex-yVd3mbsV.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CrIGjD28.js";
-import "./remotes-C3xPRtfg.js";
-import { c as listRecords, d as renderRawLog, f as resolveOne, g as writeToIpc, m as snapshotStatus, r as controlCodeFromName, u as readNotes } from "./subcommands-tH8JdrBS.js";
+import { r as getInstalledPackage } from "./versionChecker-D-drPifS.js";
+import "./pidStore-B5vBu8Px.js";
+import "./globalPidIndex-gZuTvTBs.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CNLy57hz.js";
+import "./remotes-BufkGk0e.js";
+import { c as listRecords, d as renderRawLog, f as resolveOne, g as writeToIpc, m as snapshotStatus, r as controlCodeFromName, u as readNotes } from "./subcommands-BLSPrqA1.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -67,13 +67,48 @@ function freshAgentEnv() {
 	return env;
 }
 const DAEMON_NAME = "agent-yes";
-async function ensureBootAutostart(oxmgrBin) {
+function resolveDaemonManager() {
+	const oxmgr = Bun.which("oxmgr");
+	const pm2 = Bun.which("pm2");
+	const override = process.env.AGENT_YES_DAEMON_MANAGER?.toLowerCase();
+	if (override === "pm2") return pm2 ? {
+		id: "pm2",
+		bin: pm2
+	} : null;
+	if (override === "oxmgr") return oxmgr ? {
+		id: "oxmgr",
+		bin: oxmgr
+	} : null;
+	return (process.platform === "win32" ? [pm2 && {
+		id: "pm2",
+		bin: pm2
+	}, oxmgr && {
+		id: "oxmgr",
+		bin: oxmgr
+	}] : [oxmgr && {
+		id: "oxmgr",
+		bin: oxmgr
+	}, pm2 && {
+		id: "pm2",
+		bin: pm2
+	}]).find((m) => !!m) ?? null;
+}
+function ayServeArgv(args) {
+	const ayBin = Bun.which("ay");
+	return [
+		...ayBin ? process.platform === "win32" ? [ayBin] : [process.execPath, ayBin] : ["ay"],
+		"serve",
+		...args
+	];
+}
+async function ensureBootAutostart(mgr) {
 	try {
-		return await Bun.spawn([
-			oxmgrBin,
+		const cmd = mgr.id === "oxmgr" ? [
+			mgr.bin,
 			"service",
 			"install"
-		], { stdio: [
+		] : [mgr.bin, "save"];
+		return await Bun.spawn(cmd, { stdio: [
 			"ignore",
 			"ignore",
 			"ignore"
@@ -93,22 +128,34 @@ async function spawnExit(cmd) {
 		return 1;
 	}
 }
-async function readDaemonServeArgs(oxmgrBin) {
+async function readDaemonServeArgs(mgr) {
 	try {
-		const p = Bun.spawn([
-			oxmgrBin,
-			"status",
-			DAEMON_NAME
-		], {
+		if (mgr.id === "oxmgr") {
+			const p = Bun.spawn([
+				mgr.bin,
+				"status",
+				DAEMON_NAME
+			], {
+				stdout: "pipe",
+				stderr: "ignore"
+			});
+			const out = await new Response(p.stdout).text();
+			if (await p.exited !== 0) return null;
+			const m = /Command:\s*(.+)/.exec(out);
+			if (!m) return null;
+			const after = /\bserve\b\s*(.*)$/.exec(m[1].trim());
+			return after ? after[1].split(/\s+/).filter(Boolean) : [];
+		}
+		const p = Bun.spawn([mgr.bin, "jlist"], {
 			stdout: "pipe",
 			stderr: "ignore"
 		});
 		const out = await new Response(p.stdout).text();
 		if (await p.exited !== 0) return null;
-		const m = /Command:\s*(.+)/.exec(out);
-		if (!m) return null;
-		const after = /\bserve\b\s*(.*)$/.exec(m[1].trim());
-		return after ? after[1].split(/\s+/).filter(Boolean) : [];
+		const proc = JSON.parse(out).find((x) => x.name === DAEMON_NAME);
+		if (!proc) return null;
+		const a = proc.pm2_env?.args ?? [];
+		return a[0] === "serve" ? a.slice(1) : a;
 	} catch {
 		return null;
 	}
@@ -130,61 +177,68 @@ async function fetchDaemonVersion(port, token) {
 	}
 }
 async function cmdServeDaemon(sub, args) {
-	const oxmgrBin = Bun.which("oxmgr");
-	if (!oxmgrBin) {
-		process.stderr.write("ay serve install: oxmgr not found\n  install with:  cargo install oxmgr\n             or: bun add -g oxmgr\n");
+	const mgr = resolveDaemonManager();
+	if (!mgr) {
+		process.stderr.write("ay serve install: no process manager found (need pm2 or oxmgr)\n  install with:  bun add -g pm2\n             or: cargo install oxmgr\n");
 		return 1;
 	}
 	if (sub === "install") {
 		const token = await loadOrCreateToken(void 0);
-		const priorArgs = await readDaemonServeArgs(oxmgrBin);
+		const priorArgs = await readDaemonServeArgs(mgr);
 		const effArgs = args.length ? args : priorArgs ?? [];
 		const current = getInstalledPackage().version;
 		if (priorArgs !== null) {
 			const runningVer = await fetchDaemonVersion(portFromArgs(effArgs), token);
 			if (runningVer === current) {
-				await ensureBootAutostart(oxmgrBin);
+				await ensureBootAutostart(mgr);
 				process.stdout.write(`'${DAEMON_NAME}' already running v${current} (up to date)\n`);
 				return 0;
 			}
 			process.stdout.write(`rolling '${DAEMON_NAME}' ${runningVer ? `v${runningVer}` : "(unknown)"} → v${current}…\n`);
 			await spawnExit([
-				oxmgrBin,
+				mgr.bin,
 				"stop",
 				DAEMON_NAME
 			]);
 			await spawnExit([
-				oxmgrBin,
+				mgr.bin,
 				"delete",
 				DAEMON_NAME
 			]);
 		}
-		const ayBin = Bun.which("ay");
-		const serveCmd = [
-			...ayBin ? [process.execPath, ayBin] : ["ay"],
-			"serve",
-			...effArgs
-		].join(" ");
-		const code = await Bun.spawn([
-			oxmgrBin,
+		const serveArgv = ayServeArgv(effArgs);
+		const startArgv = mgr.id === "oxmgr" ? [
+			mgr.bin,
 			"start",
-			serveCmd,
+			serveArgv.join(" "),
 			"--name",
 			DAEMON_NAME,
 			"--restart",
 			"always"
-		], { stdio: [
+		] : [
+			mgr.bin,
+			"start",
+			serveArgv[0],
+			"--name",
+			DAEMON_NAME,
+			"--interpreter",
+			"none",
+			"--",
+			...serveArgv.slice(1)
+		];
+		const code = await Bun.spawn(startArgv, { stdio: [
 			"ignore",
 			"inherit",
 			"inherit"
 		] }).exited;
 		if (code === 0) {
-			const onBoot = await ensureBootAutostart(oxmgrBin);
+			const onBoot = await ensureBootAutostart(mgr);
 			const port = portFromArgs(effArgs);
 			const webrtcish = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share"));
 			const httpish = effArgs.some((a) => a.startsWith("--http") || a.startsWith("--share")) || !effArgs.some((a) => a.startsWith("--webrtc"));
-			process.stdout.write(`\n${priorArgs !== null ? `rolled '${DAEMON_NAME}' forward to` : `installed '${DAEMON_NAME}' as a daemon via oxmgr —`} v${current}\n`);
-			process.stdout.write(onBoot ? `start-on-boot: enabled (oxmgr registered with the system init)\n` : `start-on-boot: not registered — run \`oxmgr service install\` to enable\n`);
+			process.stdout.write(`\n${priorArgs !== null ? `rolled '${DAEMON_NAME}' forward to` : `installed '${DAEMON_NAME}' as a daemon via ${mgr.id} —`} v${current}\n`);
+			if (mgr.id === "oxmgr") process.stdout.write(onBoot ? `start-on-boot: enabled (oxmgr registered with the system init)\n` : `start-on-boot: not registered — run \`oxmgr service install\` to enable\n`);
+			else process.stdout.write(onBoot ? `start-on-boot: pm2 list saved (run \`pm2 startup\` once for boot resurrect)\n` : `start-on-boot: \`pm2 save\` failed — run it manually to persist across reboots\n`);
 			process.stdout.write(`token: ${token}\n\n`);
 			if (httpish) {
 				process.stdout.write(`  ay ls   ${token}@<host>:${port}\n`);
@@ -196,17 +250,25 @@ async function cmdServeDaemon(sub, args) {
 		}
 		return code ?? 1;
 	}
-	if (sub === "uninstall") return await Bun.spawn([
-		oxmgrBin,
-		"delete",
-		DAEMON_NAME
-	], { stdio: [
-		"ignore",
-		"inherit",
-		"inherit"
-	] }).exited ?? 1;
+	if (sub === "uninstall") {
+		const code = await Bun.spawn([
+			mgr.bin,
+			"delete",
+			DAEMON_NAME
+		], { stdio: [
+			"ignore",
+			"inherit",
+			"inherit"
+		] }).exited ?? 1;
+		if (mgr.id === "pm2" && code === 0) await Bun.spawn([mgr.bin, "save"], { stdio: [
+			"ignore",
+			"ignore",
+			"ignore"
+		] }).exited;
+		return code;
+	}
 	if (sub === "logs") return await Bun.spawn([
-		oxmgrBin,
+		mgr.bin,
 		"logs",
 		DAEMON_NAME,
 		...args
@@ -234,7 +296,7 @@ Modes (default: --http):
   --share [URL]     Legacy alias for --http --webrtc
 
 Options:
-  --port N          Port to listen on (default: ${DEFAULT_PORT})\n  --host HOST       Interface to bind (default: 127.0.0.1; use 0.0.0.0 to expose)\n  --token TOKEN     Auth token (auto-generated and saved if omitted)\n  -d, --daemon      Install these flags as a background daemon via oxmgr\n                    (same as: ay serve install <flags>)\n  --allow-spawn     Deprecated no-op — the console can always spawn agents\n  --tls-cert FILE   TLS certificate PEM\n  --tls-key  FILE   TLS private key PEM\n\nSubcommands:\n  ay serve install    install as background daemon via oxmgr\n  ay serve uninstall  remove daemon\n  ay serve logs       view daemon logs\n\nOnce running, connect from another machine:\n  ay ls   <token>@<host>:${DEFAULT_PORT}\n  ay remote add <alias> http://<token>@<host>:${DEFAULT_PORT}\n`);
+  --port N          Port to listen on (default: ${DEFAULT_PORT})\n  --host HOST       Interface to bind (default: 127.0.0.1; use 0.0.0.0 to expose)\n  --token TOKEN     Auth token (auto-generated and saved if omitted)\n  -d, --daemon      Install these flags as a background daemon (pm2/oxmgr)\n                    (same as: ay serve install <flags>)\n  --allow-spawn     Deprecated no-op — the console can always spawn agents\n  --tls-cert FILE   TLS certificate PEM\n  --tls-key  FILE   TLS private key PEM\n\nSubcommands:\n  ay serve install    install as background daemon (pm2 on Windows, else oxmgr)\n  ay serve uninstall  remove daemon\n  ay serve logs       view daemon logs\n\nOnce running, connect from another machine:\n  ay ls   <token>@<host>:${DEFAULT_PORT}\n  ay remote add <alias> http://<token>@<host>:${DEFAULT_PORT}\n`);
 		return 0;
 	}
 	const sub = rest[0];
@@ -269,7 +331,7 @@ Options:
 		alias: "d",
 		type: "boolean",
 		default: false,
-		description: "Install as a background daemon via oxmgr (same as: ay serve install <flags>)"
+		description: "Install as a background daemon (same as: ay serve install <flags>)"
 	}).option("allow-spawn", {
 		type: "boolean",
 		default: false,
@@ -758,7 +820,7 @@ Options:
 		const webrtcVal = argv.webrtc ?? argv.share;
 		const explicitUrl = typeof webrtcVal === "string" && webrtcVal.startsWith("webrtc://") ? webrtcVal : void 0;
 		try {
-			const { startShare, loadOrCreateShareRoom } = await import("./share-DwzKXEsJ.js");
+			const { startShare, loadOrCreateShareRoom } = await import("./share-BM-H85FE.js");
 			const { link, close } = await startShare({
 				url: explicitUrl ?? await loadOrCreateShareRoom(),
 				localFetch: apiFetch,
@@ -789,4 +851,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-uhfwjvBd.js.map
+//# sourceMappingURL=serve-DKpVuQyU.js.map

package/dist/setup-BFiD3CAi.js

@@ -0,0 +1,82 @@
+import { t as agentYesHome } from "./agentYesHome-BvaUOzCV.js";
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import path from "path";
+import { existsSync as existsSync$1 } from "node:fs";
+import { stdin, stdout } from "node:process";
+import { createInterface } from "node:readline/promises";
+
+//#region ts/workspaceConfig.ts
+function configPath() {
+	return path.join(agentYesHome(), "config.json");
+}
+function readConfig() {
+	try {
+		return JSON.parse(readFileSync(configPath(), "utf-8"));
+	} catch {
+		return {};
+	}
+}
+/** Expand a leading `~` (`~` or `~/x`) to an absolute home-based path. */
+function expandTilde(p) {
+	const s = p.trim();
+	if (s === "~") return homedir();
+	if (s.startsWith("~/") || s.startsWith("~\\")) return path.join(homedir(), s.slice(2));
+	return s;
+}
+/** The configured workspace root (absolute), or the home dir if unset. */
+function getWorkspaceRoot() {
+	const w = readConfig().workspace;
+	return w && w.trim() ? w : homedir();
+}
+/** Persist the workspace root, tilde-expanded and resolved to an absolute path. */
+function setWorkspaceRoot(dir) {
+	const abs = path.resolve(expandTilde(dir));
+	const cfg = readConfig();
+	cfg.workspace = abs;
+	mkdirSync(agentYesHome(), { recursive: true });
+	writeFileSync(configPath(), JSON.stringify(cfg, null, 2));
+	return abs;
+}
+
+//#endregion
+//#region ts/setup.ts
+async function cmdSetup(rest) {
+	if (rest.includes("-h") || rest.includes("--help")) {
+		process.stdout.write("Usage: ay setup [workspace-dir] [--no-share] [--port N]\n\nGuided setup:\n  1. pick the workspace root new agents spawn into (default: your home dir)\n  2. share this machine to the agent-yes.com console (a restart-on-boot daemon)\n\nOptions:\n  workspace-dir   default directory for new agents (skips the prompt)\n  --no-share      set the workspace only; don't install the share daemon\n  --port N        HTTP API port for the share daemon (default: 7432)\n");
+		return 0;
+	}
+	const noShare = rest.includes("--no-share");
+	const portIdx = rest.indexOf("--port");
+	const port = portIdx >= 0 ? rest[portIdx + 1] : void 0;
+	let ws = rest.filter((a, i) => !a.startsWith("-") && i !== portIdx + 1)[0];
+	if (!ws) {
+		const current = getWorkspaceRoot();
+		if (stdin.isTTY && stdout.isTTY) {
+			const rl = createInterface({
+				input: stdin,
+				output: stdout
+			});
+			try {
+				ws = (await rl.question(`Workspace root for new agents [${current}]: `)).trim() || current;
+			} finally {
+				rl.close();
+			}
+		} else ws = current;
+	}
+	const abs = setWorkspaceRoot(ws);
+	process.stdout.write(`workspace root: ${abs}\n`);
+	if (!existsSync$1(abs)) process.stderr.write(`  note: that directory doesn't exist yet — create it, or agents spawned there will fail\n`);
+	if (noShare) return 0;
+	process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
+	const { cmdServe } = await import("./serve-DKpVuQyU.js");
+	return cmdServe([
+		"install",
+		"--share",
+		...port ? ["--port", port] : []
+	]);
+}
+
+//#endregion
+export { cmdSetup };
+//# sourceMappingURL=setup-BFiD3CAi.js.map

package/dist/{share-DwzKXEsJ.js → share-BM-H85FE.js}

@@ -215,4 +215,4 @@ async function startShare(opts) {
 
 //#endregion
 export { loadOrCreateShareRoom, startShare };
-//# sourceMappingURL=share-DwzKXEsJ.js.map
+//# sourceMappingURL=share-BM-H85FE.js.map

package/dist/{subcommands-tH8JdrBS.js → subcommands-BLSPrqA1.js}

@@ -1,5 +1,5 @@
-import { i as readGlobalPids } from "./globalPidIndex-yVd3mbsV.js";
-import { a as resolveRemoteSpec, i as readRemotes } from "./remotes-C3xPRtfg.js";
+import { i as readGlobalPids } from "./globalPidIndex-gZuTvTBs.js";
+import { a as resolveRemoteSpec, i as readRemotes } from "./remotes-BufkGk0e.js";
 import ms from "ms";
 import yargs from "yargs";
 import { appendFile, mkdir, open, readFile, stat, writeFile } from "fs/promises";
@@ -231,15 +231,15 @@ async function runSubcommand(argv) {
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-uhfwjvBd.js");
+				const { cmdServe } = await import("./serve-DKpVuQyU.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup.ts");
+				const { cmdSetup } = await import("./setup-BFiD3CAi.js");
 				return cmdSetup(rest);
 			}
 			case "remote": {
-				const { cmdRemote } = await import("./remotes-C9WMt5PY.js");
+				const { cmdRemote } = await import("./remotes-DavR4Hca.js");
 				return cmdRemote(rest);
 			}
 			case "help": return cmdHelp();
@@ -1680,4 +1680,4 @@ async function cmdStatus(rest) {
 
 //#endregion
 export { finalizedLines as a, listRecords as c, renderRawLog as d, resolveOne as f, writeToIpc as g, stopTipForCli as h, cursorAbs as i, matchKeyword as l, snapshotStatus as m, cmdHelp as n, isPidAlive as o, runSubcommand as p, controlCodeFromName as r, isSubcommand as s, GRACEFUL_EXIT_COMMANDS as t, readNotes as u };
-//# sourceMappingURL=subcommands-tH8JdrBS.js.map
+//# sourceMappingURL=subcommands-BLSPrqA1.js.map

package/dist/{subcommands-FtwGxxtc.js → subcommands-CIrlUP1E.js}

@@ -1,6 +1,6 @@
 import "./logger-B9h0djqx.js";
-import "./globalPidIndex-yVd3mbsV.js";
-import "./remotes-C3xPRtfg.js";
-import { a as finalizedLines, c as listRecords, d as renderRawLog, f as resolveOne, g as writeToIpc, h as stopTipForCli, i as cursorAbs, l as matchKeyword, m as snapshotStatus, n as cmdHelp, o as isPidAlive, p as runSubcommand, r as controlCodeFromName, s as isSubcommand, t as GRACEFUL_EXIT_COMMANDS, u as readNotes } from "./subcommands-tH8JdrBS.js";
+import "./globalPidIndex-gZuTvTBs.js";
+import "./remotes-BufkGk0e.js";
+import { a as finalizedLines, c as listRecords, d as renderRawLog, f as resolveOne, g as writeToIpc, h as stopTipForCli, i as cursorAbs, l as matchKeyword, m as snapshotStatus, n as cmdHelp, o as isPidAlive, p as runSubcommand, r as controlCodeFromName, s as isSubcommand, t as GRACEFUL_EXIT_COMMANDS, u as readNotes } from "./subcommands-BLSPrqA1.js";
 
 export { cmdHelp, isSubcommand, runSubcommand };

package/dist/{tray-CWQe9DMY.js → tray-B8_rx1iu.js}

@@ -175,4 +175,4 @@ async function startTray() {
 
 //#endregion
 export { ensureTray, startTray };
-//# sourceMappingURL=tray-CWQe9DMY.js.map
+//# sourceMappingURL=tray-B8_rx1iu.js.map

package/dist/{ts-DYzATaI_.js → ts-BUpRpKjH.js}

@@ -1,8 +1,9 @@
 import { n as logger, t as addTransport } from "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-D-OYziVA.js";
-import { n as agentYesHome, t as PidStore } from "./pidStore-BcGnnKQf.js";
+import { r as getInstalledPackage } from "./versionChecker-D-drPifS.js";
+import { t as agentYesHome } from "./agentYesHome-BvaUOzCV.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-CJxsoGdb.js";
-import { i as readGlobalPids } from "./globalPidIndex-yVd3mbsV.js";
+import { t as PidStore } from "./pidStore-B5vBu8Px.js";
+import { i as readGlobalPids } from "./globalPidIndex-gZuTvTBs.js";
 import { arch, platform } from "process";
 import { execSync } from "child_process";
 import { closeSync, constants, createReadStream, existsSync, mkdirSync, openSync } from "fs";
@@ -1039,7 +1040,7 @@ async function notifyWebhook(status, details, cwd = process.cwd()) {
 
 //#endregion
 //#region ts/index.ts
-const config = await import("./agent-yes.config-1LMoK18R.js").then((mod) => mod.default || mod);
+const config = await import("./agent-yes.config-kmtJKJHk.js").then((mod) => mod.default || mod);
 const CLIS_CONFIG = config.clis;
 /**
 * Main function to run agent-cli with automatic yes/no responses
@@ -1714,4 +1715,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-DYzATaI_.js.map
+//# sourceMappingURL=ts-BUpRpKjH.js.map

package/dist/{versionChecker-D-OYziVA.js → versionChecker-D-drPifS.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.118.0";
+var version = "1.118.2";
 
 //#endregion
 //#region ts/versionChecker.ts
@@ -221,4 +221,4 @@ async function displayVersion() {
 
 //#endregion
 export { versionString as i, displayVersion as n, getInstalledPackage as r, checkAndAutoUpdate as t };
-//# sourceMappingURL=versionChecker-D-OYziVA.js.map
+//# sourceMappingURL=versionChecker-D-drPifS.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-yes",
-  "version": "1.118.0",
+  "version": "1.118.2",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",

package/ts/serve.ts

@@ -98,20 +98,53 @@ function freshAgentEnv(): Record<string, string> {
 
 const DAEMON_NAME = "agent-yes";
 
-// Register the oxmgr daemon with the platform init system (launchd on macOS,
-// systemd on Linux, Task Scheduler on Windows) so managed processes — including
-// the agent-yes daemon — come back after a *reboot*, not just a crash. Idempotent:
-// a no-op if the service is already installed. Best-effort: returns false on any
-// failure (e.g. a system-level systemd unit that needs sudo) without aborting the
-// install — the process is still managed, just not boot-persistent.
-async function ensureBootAutostart(oxmgrBin: string): Promise<boolean> {
+type DaemonManager = { id: "oxmgr" | "pm2"; bin: string };
+
+// Pick the process manager used to daemonize `ay serve`. oxmgr's daemon talks
+// over a fixed TCP port; on Windows a crashed daemon routinely leaves the
+// socket orphaned on a dead PID, which wedges every subsequent oxmgr command
+// with "daemon did not become ready in time". pm2's named-pipe daemon does not
+// have that failure mode, so we prefer pm2 on Windows. Elsewhere oxmgr stays
+// the default. AGENT_YES_DAEMON_MANAGER=pm2|oxmgr forces a choice.
+function resolveDaemonManager(): DaemonManager | null {
+  const oxmgr = Bun.which("oxmgr");
+  const pm2 = Bun.which("pm2");
+  const override = process.env.AGENT_YES_DAEMON_MANAGER?.toLowerCase();
+  if (override === "pm2") return pm2 ? { id: "pm2", bin: pm2 } : null;
+  if (override === "oxmgr") return oxmgr ? { id: "oxmgr", bin: oxmgr } : null;
+  const order: Array<DaemonManager | null> =
+    process.platform === "win32"
+      ? [pm2 && { id: "pm2", bin: pm2 }, oxmgr && { id: "oxmgr", bin: oxmgr }]
+      : [oxmgr && { id: "oxmgr", bin: oxmgr }, pm2 && { id: "pm2", bin: pm2 }];
+  return order.find((m): m is DaemonManager => !!m) ?? null;
+}
+
+// Resolve the argv that launches `ay serve …` from the daemon. The daemon's
+// environment may not have ~/.bun/bin on PATH, so we use an absolute path.
+// On Windows the `ay` bin is a self-contained launcher (ay.exe) we exec
+// directly; on POSIX it's a `#!/usr/bin/env bun` script we run through bun.
+function ayServeArgv(args: string[]): string[] {
+  const ayBin = Bun.which("ay");
+  const launcher = ayBin
+    ? process.platform === "win32"
+      ? [ayBin]
+      : [process.execPath, ayBin]
+    : ["ay"];
+  return [...launcher, "serve", ...args];
+}
+
+// Register the daemon with the platform init system so it comes back after a
+// *reboot*, not just a crash. oxmgr wires launchd/systemd/Task Scheduler via
+// `oxmgr service install`; pm2 persists its process list with `pm2 save` (a
+// once-installed `pm2 startup` hook then resurrects it on boot). Idempotent and
+// best-effort: returns false on any failure without aborting the install — the
+// process is still crash-managed, just not guaranteed boot-persistent.
+async function ensureBootAutostart(mgr: DaemonManager): Promise<boolean> {
   try {
-    // --system defaults to "auto" (launchd/systemd/Task Scheduler by platform);
-    // it's a `service`-level flag, so passing it after `install` is rejected.
-    const svc = Bun.spawn([oxmgrBin, "service", "install"], {
-      stdio: ["ignore", "ignore", "ignore"],
-    });
-    return (await svc.exited) === 0;
+    // oxmgr's --system defaults to "auto" (launchd/systemd/Task Scheduler); it's
+    // a `service`-level flag, so it goes before the subcommand, not after.
+    const cmd = mgr.id === "oxmgr" ? [mgr.bin, "service", "install"] : [mgr.bin, "save"];
+    return (await Bun.spawn(cmd, { stdio: ["ignore", "ignore", "ignore"] }).exited) === 0;
   } catch {
     return false;
   }
@@ -125,18 +158,29 @@ async function spawnExit(cmd: string[]): Promise<number> {
   }
 }
 
-// The `serve` args the running daemon was started with, parsed out of oxmgr's
-// stored command line (`… ay serve --share --port 7433`). null when no daemon is
-// registered. Lets a bare `ay serve install` re-launch with the SAME args.
-async function readDaemonServeArgs(oxmgrBin: string): Promise<string[] | null> {
+// The `serve` args the running daemon was started with, so a bare
+// `ay serve install` can re-launch with the SAME args. null when no daemon is
+// registered. oxmgr stores the full command line (`… ay serve --share`); pm2
+// keeps the post-`--` argv in pm2_env.args (with a leading "serve" we strip).
+async function readDaemonServeArgs(mgr: DaemonManager): Promise<string[] | null> {
   try {
-    const p = Bun.spawn([oxmgrBin, "status", DAEMON_NAME], { stdout: "pipe", stderr: "ignore" });
+    if (mgr.id === "oxmgr") {
+      const p = Bun.spawn([mgr.bin, "status", DAEMON_NAME], { stdout: "pipe", stderr: "ignore" });
+      const out = await new Response(p.stdout).text();
+      if ((await p.exited) !== 0) return null;
+      const m = /Command:\s*(.+)/.exec(out);
+      if (!m) return null;
+      const after = /\bserve\b\s*(.*)$/.exec(m[1]!.trim());
+      return after ? after[1]!.split(/\s+/).filter(Boolean) : [];
+    }
+    const p = Bun.spawn([mgr.bin, "jlist"], { stdout: "pipe", stderr: "ignore" });
     const out = await new Response(p.stdout).text();
     if ((await p.exited) !== 0) return null;
-    const m = /Command:\s*(.+)/.exec(out);
-    if (!m) return null;
-    const after = /\bserve\b\s*(.*)$/.exec(m[1]!.trim());
-    return after ? after[1]!.split(/\s+/).filter(Boolean) : [];
+    const list = JSON.parse(out) as Array<{ name?: string; pm2_env?: { args?: string[] } }>;
+    const proc = list.find((x) => x.name === DAEMON_NAME);
+    if (!proc) return null;
+    const a = proc.pm2_env?.args ?? [];
+    return a[0] === "serve" ? a.slice(1) : a;
   } catch {
     return null;
   }
@@ -164,12 +208,12 @@ async function fetchDaemonVersion(port: number, token: string): Promise<string |
 }
 
 async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
-  const oxmgrBin = Bun.which("oxmgr");
-  if (!oxmgrBin) {
+  const mgr = resolveDaemonManager();
+  if (!mgr) {
     process.stderr.write(
-      "ay serve install: oxmgr not found\n" +
-        "  install with:  cargo install oxmgr\n" +
-        "             or: bun add -g oxmgr\n",
+      "ay serve install: no process manager found (need pm2 or oxmgr)\n" +
+        "  install with:  bun add -g pm2\n" +
+        "             or: cargo install oxmgr\n",
     );
     return 1;
   }
@@ -181,7 +225,7 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
     // started with (so a bare `ay serve install` stays "the same daemon"), unless
     // new args are given. The persisted room + token mean the share link is
     // unchanged across the restart.
-    const priorArgs = await readDaemonServeArgs(oxmgrBin);
+    const priorArgs = await readDaemonServeArgs(mgr);
     const effArgs = args.length ? args : (priorArgs ?? []);
     const current = getInstalledPackage().version;
 
@@ -189,34 +233,42 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
       // A daemon already exists — only disturb it if it's actually outdated.
       const runningVer = await fetchDaemonVersion(portFromArgs(effArgs), token);
       if (runningVer === current) {
-        await ensureBootAutostart(oxmgrBin);
+        await ensureBootAutostart(mgr);
         process.stdout.write(`'${DAEMON_NAME}' already running v${current} (up to date)\n`);
         return 0;
       }
       // Outdated (or unreachable/too-old to report) → graceful roll-forward.
-      // `oxmgr stop` sends SIGTERM, which cmdServe handles cleanly (closing share
+      // `stop` sends SIGTERM, which cmdServe handles cleanly (closing share
       // peers so browsers reconnect fast), then we re-create with the new binary.
       process.stdout.write(
         `rolling '${DAEMON_NAME}' ${runningVer ? `v${runningVer}` : "(unknown)"} → v${current}…\n`,
       );
-      await spawnExit([oxmgrBin, "stop", DAEMON_NAME]);
-      await spawnExit([oxmgrBin, "delete", DAEMON_NAME]);
+      await spawnExit([mgr.bin, "stop", DAEMON_NAME]);
+      await spawnExit([mgr.bin, "delete", DAEMON_NAME]);
     }
 
-    // Build the ay serve command with forwarded args (port, host, --webrtc, etc.).
-    // Absolute paths: oxmgr's daemon environment may not have ~/.bun/bin in
-    // PATH, so a bare `ay` (or its `#!/usr/bin/env bun` shebang) fails to spawn.
-    const ayBin = Bun.which("ay");
-    const serveCmd = [...(ayBin ? [process.execPath, ayBin] : ["ay"]), "serve", ...effArgs].join(
-      " ",
-    );
-    const proc = Bun.spawn(
-      [oxmgrBin, "start", serveCmd, "--name", DAEMON_NAME, "--restart", "always"],
-      { stdio: ["ignore", "inherit", "inherit"] },
-    );
+    // oxmgr takes the command as one string; pm2 takes the binary plus its
+    // args after `--`. Both auto-restart on crash by default (pm2) / via the
+    // explicit flag (oxmgr).
+    const serveArgv = ayServeArgv(effArgs);
+    const startArgv =
+      mgr.id === "oxmgr"
+        ? [mgr.bin, "start", serveArgv.join(" "), "--name", DAEMON_NAME, "--restart", "always"]
+        : [
+            mgr.bin,
+            "start",
+            serveArgv[0]!,
+            "--name",
+            DAEMON_NAME,
+            "--interpreter",
+            "none",
+            "--",
+            ...serveArgv.slice(1),
+          ];
+    const proc = Bun.spawn(startArgv, { stdio: ["ignore", "inherit", "inherit"] });
     const code = await proc.exited;
     if (code === 0) {
-      const onBoot = await ensureBootAutostart(oxmgrBin);
+      const onBoot = await ensureBootAutostart(mgr);
       const port = portFromArgs(effArgs);
       // Mirror cmdServe's mode resolution: webrtc-only daemons open no HTTP port.
       const webrtcish = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share"));
@@ -224,13 +276,20 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
         effArgs.some((a) => a.startsWith("--http") || a.startsWith("--share")) ||
         !effArgs.some((a) => a.startsWith("--webrtc"));
       process.stdout.write(
-        `\n${priorArgs !== null ? `rolled '${DAEMON_NAME}' forward to` : `installed '${DAEMON_NAME}' as a daemon via oxmgr —`} v${current}\n`,
-      );
-      process.stdout.write(
-        onBoot
-          ? `start-on-boot: enabled (oxmgr registered with the system init)\n`
-          : `start-on-boot: not registered — run \`oxmgr service install\` to enable\n`,
+        `\n${priorArgs !== null ? `rolled '${DAEMON_NAME}' forward to` : `installed '${DAEMON_NAME}' as a daemon via ${mgr.id} —`} v${current}\n`,
       );
+      if (mgr.id === "oxmgr")
+        process.stdout.write(
+          onBoot
+            ? `start-on-boot: enabled (oxmgr registered with the system init)\n`
+            : `start-on-boot: not registered — run \`oxmgr service install\` to enable\n`,
+        );
+      else
+        process.stdout.write(
+          onBoot
+            ? `start-on-boot: pm2 list saved (run \`pm2 startup\` once for boot resurrect)\n`
+            : `start-on-boot: \`pm2 save\` failed — run it manually to persist across reboots\n`,
+        );
       process.stdout.write(`token: ${token}\n\n`);
       if (httpish) {
         process.stdout.write(`  ay ls   ${token}@<host>:${port}\n`);
@@ -249,14 +308,18 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
   }
 
   if (sub === "uninstall") {
-    const proc = Bun.spawn([oxmgrBin, "delete", DAEMON_NAME], {
+    const proc = Bun.spawn([mgr.bin, "delete", DAEMON_NAME], {
       stdio: ["ignore", "inherit", "inherit"],
     });
-    return (await proc.exited) ?? 1;
+    const code = (await proc.exited) ?? 1;
+    // Drop it from the persisted pm2 list too, so `pm2 resurrect` won't revive it.
+    if (mgr.id === "pm2" && code === 0)
+      await Bun.spawn([mgr.bin, "save"], { stdio: ["ignore", "ignore", "ignore"] }).exited;
+    return code;
   }
 
   if (sub === "logs") {
-    const proc = Bun.spawn([oxmgrBin, "logs", DAEMON_NAME, ...args], {
+    const proc = Bun.spawn([mgr.bin, "logs", DAEMON_NAME, ...args], {
       stdio: ["ignore", "inherit", "inherit"],
     });
     return (await proc.exited) ?? 1;
@@ -287,13 +350,13 @@ export async function cmdServe(rest: string[]): Promise<number> {
         `  --port N          Port to listen on (default: ${DEFAULT_PORT})\n` +
         `  --host HOST       Interface to bind (default: 127.0.0.1; use 0.0.0.0 to expose)\n` +
         `  --token TOKEN     Auth token (auto-generated and saved if omitted)\n` +
-        `  -d, --daemon      Install these flags as a background daemon via oxmgr\n` +
+        `  -d, --daemon      Install these flags as a background daemon (pm2/oxmgr)\n` +
         `                    (same as: ay serve install <flags>)\n` +
         `  --allow-spawn     Deprecated no-op — the console can always spawn agents\n` +
         `  --tls-cert FILE   TLS certificate PEM\n` +
         `  --tls-key  FILE   TLS private key PEM\n\n` +
         `Subcommands:\n` +
-        `  ay serve install    install as background daemon via oxmgr\n` +
+        `  ay serve install    install as background daemon (pm2 on Windows, else oxmgr)\n` +
         `  ay serve uninstall  remove daemon\n` +
         `  ay serve logs       view daemon logs\n\n` +
         `Once running, connect from another machine:\n` +
@@ -337,7 +400,7 @@ export async function cmdServe(rest: string[]): Promise<number> {
       alias: "d",
       type: "boolean",
       default: false,
-      description: "Install as a background daemon via oxmgr (same as: ay serve install <flags>)",
+      description: "Install as a background daemon (same as: ay serve install <flags>)",
     })
     .option("allow-spawn", {
       type: "boolean",
@@ -350,7 +413,7 @@ export async function cmdServe(rest: string[]): Promise<number> {
 
   const argv = await y.parseAsync();
 
-  // --daemon/-d: install these exact flags as the oxmgr daemon instead of
+  // --daemon/-d: install these exact flags as the background daemon instead of
   // serving in the foreground (sugar for `ay serve install <flags>`).
   if (argv.daemon) {
     const fwd = rest.filter((a) => a !== "--daemon" && a !== "-d");

package/ts/setup.spec.ts

@@ -0,0 +1,42 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import path from "path";
+import { cmdSetup } from "./setup.ts";
+import { getWorkspaceRoot } from "./workspaceConfig.ts";
+
+// Guards against the regression where `ay setup` was registered + documented but
+// its module was missing ("Cannot find module './setup.ts'"). Exercises the
+// --no-share path only, so no daemon is installed.
+describe("cmdSetup", () => {
+  let original: string | undefined;
+  let tmp: string;
+  beforeEach(() => {
+    original = process.env.AGENT_YES_HOME;
+    tmp = mkdtempSync(path.join(tmpdir(), "ay-setup-"));
+    process.env.AGENT_YES_HOME = tmp;
+  });
+  afterEach(() => {
+    if (original === undefined) delete process.env.AGENT_YES_HOME;
+    else process.env.AGENT_YES_HOME = original;
+    rmSync(tmp, { recursive: true, force: true });
+  });
+
+  it("--help returns 0 without touching config", async () => {
+    expect(await cmdSetup(["--help"])).toBe(0);
+  });
+
+  it("--no-share sets the workspace root and skips the daemon", async () => {
+    const dir = path.join(tmp, "myspace");
+    const code = await cmdSetup(["--no-share", dir]);
+    expect(code).toBe(0);
+    expect(getWorkspaceRoot()).toBe(path.resolve(dir));
+  });
+
+  it("--no-share with a --port flag still treats the path as the workspace", async () => {
+    const dir = path.join(tmp, "ws");
+    const code = await cmdSetup(["--no-share", "--port", "7440", dir]);
+    expect(code).toBe(0);
+    expect(getWorkspaceRoot()).toBe(path.resolve(dir));
+  });
+});

package/ts/setup.ts

@@ -0,0 +1,67 @@
+import { existsSync } from "node:fs";
+import { stdin, stdout } from "node:process";
+import { createInterface } from "node:readline/promises";
+import { getWorkspaceRoot, setWorkspaceRoot } from "./workspaceConfig.ts";
+
+// `ay setup` — guided onboarding. Two steps:
+//   1. choose the workspace root (the default cwd new agents spawn into when the
+//      console doesn't pass one — see workspaceConfig), and
+//   2. share this machine to the agent-yes.com console over WebRTC, installed as a
+//      restart-on-boot daemon (delegates to `ay serve install --share`).
+//
+// Designed to degrade gracefully: with a TTY it prompts (defaulting to the
+// current/home workspace); piped or in a script it takes the first positional as
+// the workspace and otherwise keeps the current one — never blocking on input.
+export async function cmdSetup(rest: string[]): Promise<number> {
+  if (rest.includes("-h") || rest.includes("--help")) {
+    process.stdout.write(
+      `Usage: ay setup [workspace-dir] [--no-share] [--port N]\n\n` +
+        `Guided setup:\n` +
+        `  1. pick the workspace root new agents spawn into (default: your home dir)\n` +
+        `  2. share this machine to the agent-yes.com console (a restart-on-boot daemon)\n\n` +
+        `Options:\n` +
+        `  workspace-dir   default directory for new agents (skips the prompt)\n` +
+        `  --no-share      set the workspace only; don't install the share daemon\n` +
+        `  --port N        HTTP API port for the share daemon (default: 7432)\n`,
+    );
+    return 0;
+  }
+
+  const noShare = rest.includes("--no-share");
+  const portIdx = rest.indexOf("--port");
+  const port = portIdx >= 0 ? rest[portIdx + 1] : undefined;
+  // The workspace is the first non-flag token (and not the value of --port).
+  const positional = rest.filter((a, i) => !a.startsWith("-") && i !== portIdx + 1);
+
+  // 1. Workspace root.
+  let ws = positional[0];
+  if (!ws) {
+    const current = getWorkspaceRoot();
+    if (stdin.isTTY && stdout.isTTY) {
+      const rl = createInterface({ input: stdin, output: stdout });
+      try {
+        const ans = (await rl.question(`Workspace root for new agents [${current}]: `)).trim();
+        ws = ans || current;
+      } finally {
+        rl.close();
+      }
+    } else {
+      ws = current; // non-interactive: keep whatever's configured (home by default)
+    }
+  }
+  const abs = setWorkspaceRoot(ws);
+  process.stdout.write(`workspace root: ${abs}\n`);
+  if (!existsSync(abs)) {
+    process.stderr.write(
+      `  note: that directory doesn't exist yet — create it, or agents spawned there will fail\n`,
+    );
+  }
+
+  if (noShare) return 0;
+
+  // 2. Share to agent-yes.com as a boot-persistent daemon. `ay serve install`
+  //    handles oxmgr registration, version roll-forward, and printing the link.
+  process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
+  const { cmdServe } = await import("./serve.ts");
+  return cmdServe(["install", "--share", ...(port ? ["--port", port] : [])]);
+}

package/dist/SUPPORTED_CLIS-BS7EiXxW.js

@@ -1,8 +0,0 @@
-import "./ts-DYzATaI_.js";
-import "./logger-B9h0djqx.js";
-import "./versionChecker-D-OYziVA.js";
-import "./pidStore-BcGnnKQf.js";
-import "./globalPidIndex-yVd3mbsV.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CrIGjD28.js";
-
-export { SUPPORTED_CLIS };

package/dist/pidStore-BLcnCpkX.js

@@ -1,5 +0,0 @@
-import "./logger-B9h0djqx.js";
-import { t as PidStore } from "./pidStore-BcGnnKQf.js";
-import "./globalPidIndex-yVd3mbsV.js";
-
-export { PidStore };