agent-yes 1.118.0 → 1.118.1

package/dist/SUPPORTED_CLIS-Bx3xCmVR.js

@@ -0,0 +1,8 @@
+import "./ts-DSvAXKGk.js";
+import "./logger-B9h0djqx.js";
+import "./versionChecker-C40LF9-T.js";
+import "./pidStore-B5vBu8Px.js";
+import "./globalPidIndex-gZuTvTBs.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-FpD7Ea6s.js";
+
+export { SUPPORTED_CLIS };

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

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-DYzATaI_.js";
+import { t as CLIS_CONFIG } from "./ts-DSvAXKGk.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-FpD7Ea6s.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-C40LF9-T.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-Ca1GYIB2.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-Bx3xCmVR.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-DSvAXKGk.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-D-OYziVA.js";
-import "./pidStore-BcGnnKQf.js";
-import "./globalPidIndex-yVd3mbsV.js";
+import "./versionChecker-C40LF9-T.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-CBvx2LeV.js}

@@ -1,11 +1,11 @@
-import "./ts-DYzATaI_.js";
+import "./ts-DSvAXKGk.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-C40LF9-T.js";
+import "./pidStore-B5vBu8Px.js";
+import "./globalPidIndex-gZuTvTBs.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-FpD7Ea6s.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-3oALzYZW.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -758,7 +758,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 +789,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-uhfwjvBd.js.map
+//# sourceMappingURL=serve-CBvx2LeV.js.map

package/dist/setup-C7BNSEaG.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-CBvx2LeV.js");
+	return cmdServe([
+		"install",
+		"--share",
+		...port ? ["--port", port] : []
+	]);
+}
+
+//#endregion
+export { cmdSetup };
+//# sourceMappingURL=setup-C7BNSEaG.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-3oALzYZW.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-CBvx2LeV.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup.ts");
+				const { cmdSetup } = await import("./setup-C7BNSEaG.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-3oALzYZW.js.map

package/dist/{subcommands-FtwGxxtc.js → subcommands-Ca1GYIB2.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-3oALzYZW.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-DSvAXKGk.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-C40LF9-T.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-DSvAXKGk.js.map

package/dist/{versionChecker-D-OYziVA.js → versionChecker-C40LF9-T.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.1";
 
 //#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-C40LF9-T.js.map

package/package.json

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

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 };