agent-yes 1.101.0 → 1.103.0

package/README.md

@@ -4,6 +4,28 @@ A wrapper tool that automates interactions with various AI CLI tools by automati
 
 ⚠️ **Important Security Warning**: Only run this on trusted repositories. This tool automatically responds to prompts and can execute commands without user confirmation. Be aware of potential prompt injection attacks where malicious code or instructions could be embedded in files or user inputs to manipulate the automated responses.
 
+## Install
+
+One-liner (installs Bun if needed, then the `ay` / `cy` / `claude-yes` … CLIs):
+
+```bash
+# macOS / Linux
+curl -fsSL https://agent-yes.com/setup.sh | sh
+```
+
+```powershell
+# Windows (PowerShell)
+irm https://agent-yes.com/setup.ps1 | iex
+```
+
+Or with a package manager you already have:
+
+```bash
+bun add -g agent-yes      # or: npm install -g agent-yes
+```
+
+Then: `ay claude` (run an agent with auto-yes) · `ay serve share` (web console + shareable link) · live console at https://agent-yes.com
+
 ## Features
 
 - **Multi-CLI Support**: Works with Claude, Gemini, Codex, Copilot, and Cursor CLI tools

package/dist/SUPPORTED_CLIS-Bfvn4t4T.js

@@ -0,0 +1,8 @@
+import "./ts-CFWQFwe3.js";
+import "./logger-B9h0djqx.js";
+import "./versionChecker-IfF6V9MT.js";
+import "./pidStore-DBjlqzo8.js";
+import "./globalPidIndex-yVd3mbsV.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DLa81elJ.js";
+
+export { SUPPORTED_CLIS };

package/dist/{SUPPORTED_CLIS-CXsHRSdB.js → SUPPORTED_CLIS-DLa81elJ.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-mo_bB4au.js";
+import { t as CLIS_CONFIG } from "./ts-CFWQFwe3.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-CXsHRSdB.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-DLa81elJ.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-BhU9-zSi.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-IfF6V9MT.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-Dt9kMsEQ.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-DDbKmEBG.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp();
 		process.exit(0);
@@ -515,7 +515,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-DGQZ0sRr.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-Bfvn4t4T.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-mo_bB4au.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-CFWQFwe3.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-BhU9-zSi.js";
+import "./versionChecker-IfF6V9MT.js";
 import "./pidStore-DBjlqzo8.js";
 import "./globalPidIndex-yVd3mbsV.js";
 

package/dist/{serve-Bbl4BGZs.js → serve-_SDEh-NR.js}

@@ -1,11 +1,11 @@
-import "./ts-mo_bB4au.js";
+import "./ts-CFWQFwe3.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-BhU9-zSi.js";
+import "./versionChecker-IfF6V9MT.js";
 import "./pidStore-DBjlqzo8.js";
 import "./globalPidIndex-yVd3mbsV.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CXsHRSdB.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DLa81elJ.js";
 import "./remotes-C3xPRtfg.js";
-import { c as readNotes, f as snapshotStatus, l as renderRawLog, m as writeToIpc, o as listRecords, r as controlCodeFromName, u as resolveOne } from "./subcommands-wyGQaaaK.js";
+import { c as readNotes, f as snapshotStatus, l as renderRawLog, m as writeToIpc, o as listRecords, r as controlCodeFromName, u as resolveOne } from "./subcommands-DZRLQ15r.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, writeFile } from "fs/promises";
 import { homedir } from "os";
@@ -482,6 +482,7 @@ Options:
 		const p = new URL(req.url).pathname;
 		if (req.method === "GET" && (p === "/" || p === "/index.html")) return serveUiFile("index.html", "text/html; charset=utf-8");
 		if (req.method === "GET" && p === "/room-client.js") return serveUiFile("room-client.js", "text/javascript; charset=utf-8");
+		if (req.method === "GET" && p === "/console-logic.js") return serveUiFile("console-logic.js", "text/javascript; charset=utf-8");
 		if (req.method === "GET" && p === "/favicon.ico") return new Response(null, { status: 204 });
 		return apiFetch(req);
 	};
@@ -551,4 +552,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-Bbl4BGZs.js.map
+//# sourceMappingURL=serve-_SDEh-NR.js.map

package/dist/{subcommands-Dt9kMsEQ.js → subcommands-DDbKmEBG.js}

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

package/dist/{subcommands-wyGQaaaK.js → subcommands-DZRLQ15r.js}

@@ -163,7 +163,7 @@ async function runSubcommand(argv) {
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-Bbl4BGZs.js");
+				const { cmdServe } = await import("./serve-_SDEh-NR.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
@@ -1452,4 +1452,4 @@ async function cmdStatus(rest) {
 
 //#endregion
 export { isSubcommand as a, readNotes as c, runSubcommand as d, snapshotStatus as f, isPidAlive as i, renderRawLog as l, writeToIpc as m, cmdHelp as n, listRecords as o, stopTipForCli as p, controlCodeFromName as r, matchKeyword as s, GRACEFUL_EXIT_COMMANDS as t, resolveOne as u };
-//# sourceMappingURL=subcommands-wyGQaaaK.js.map
+//# sourceMappingURL=subcommands-DZRLQ15r.js.map

package/dist/{ts-mo_bB4au.js → ts-CFWQFwe3.js}

@@ -1,5 +1,5 @@
 import { n as logger, t as addTransport } from "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-BhU9-zSi.js";
+import { r as getInstalledPackage } from "./versionChecker-IfF6V9MT.js";
 import { n as agentYesHome, t as PidStore } from "./pidStore-DBjlqzo8.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-CJxsoGdb.js";
 import { i as readGlobalPids } from "./globalPidIndex-yVd3mbsV.js";
@@ -1714,4 +1714,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-mo_bB4au.js.map
+//# sourceMappingURL=ts-CFWQFwe3.js.map

package/dist/{versionChecker-BhU9-zSi.js → versionChecker-IfF6V9MT.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.101.0";
+var version = "1.103.0";
 
 //#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-BhU9-zSi.js.map
+//# sourceMappingURL=versionChecker-IfF6V9MT.js.map

package/lab/ui/console-logic.js

@@ -0,0 +1,79 @@
+// Pure, DOM-free logic for the agent-yes console (lab/ui/index.html).
+//
+// Extracted into its own ES module so it can be unit-tested in vitest
+// (tests/ui-logic/console-logic.spec.ts) while the browser imports it directly
+// — no build step. Everything here is a pure function of its arguments: no
+// document/window/localStorage access, no Date.now() except via an injected
+// `now` so age() is deterministic under test.
+
+// An agent entry as surfaced by /api/ls (the fields this module reads):
+//   { cli, cwd, title, prompt, status, started_at, pid, _host }
+
+// claude is the default CLI — show the cli name only when it differs, so the
+// common case stays uncluttered and the identity (repo/branch) leads instead.
+export const cliLabel = (e) => (e.cli && e.cli !== "claude" ? e.cli : "");
+
+// Parse owner/repo/branch from a cwd like .../ws/<owner>/<repo>/tree/<branch>.
+export function repoBranch(e) {
+  const m = /\/([^/]+)\/([^/]+)\/tree\/([^/]+)/.exec(e.cwd || "");
+  return m ? { owner: m[1], repo: m[2], branch: m[3] } : null;
+}
+
+// Identity string for the left panel. cap=true → repo/branch each clipped to
+// 3 chars for the compact one-line view (e.g. "age/mai").
+export function ident(e, cap) {
+  const rb = repoBranch(e);
+  if (!rb) return "";
+  const c = (s) => (cap && s.length > 3 ? s.slice(0, 3) : s);
+  return `${c(rb.repo)}/${c(rb.branch)}`;
+}
+
+// Derive codehost-style mnemonic tags from a cwd like .../ws/<owner>/<repo>/tree/<wt>.
+export function tagsFor(e) {
+  const t = [];
+  const rb = repoBranch(e);
+  if (rb) {
+    t.push(["repo", `${rb.owner}/${rb.repo}`], ["wt", rb.branch]);
+  }
+  const cli = cliLabel(e);
+  if (cli) t.push(["cli", cli]);
+  if (e._host) t.push(["host", e._host]); // codehost rooms: which machine
+  return t;
+}
+
+// Human age of an agent ("12s" / "5m" / "3h"). `now` is injectable so tests
+// don't depend on the wall clock; the browser calls age(e) and gets Date.now().
+export function age(e, now = Date.now()) {
+  if (!e.started_at) return "";
+  const s = Math.max(0, (now - e.started_at) / 1000);
+  if (s < 60) return Math.floor(s) + "s";
+  if (s < 3600) return Math.floor(s / 60) + "m";
+  return Math.floor(s / 3600) + "h";
+}
+
+// Filter predicate: every space-separated token must match. A `key:value` token
+// matches against the mnemonic tags (repo/wt/cli/host); a bare token is a
+// case-insensitive substring search over title/prompt/cli/cwd/status.
+export function matches(e, toks) {
+  const hay =
+    (e.title || "") + " " + (e.prompt || "") + " " + e.cli + " " + (e.cwd || "") + " " + e.status;
+  return toks.every((tok) => {
+    tok = tok.toLowerCase();
+    const ci = tok.indexOf(":");
+    if (ci > 0) {
+      const k = tok.slice(0, ci),
+        v = tok.slice(ci + 1);
+      return tagsFor(e).some(([tk, tv]) => tk === k && tv.toLowerCase().includes(v));
+    }
+    return hay.toLowerCase().includes(tok);
+  });
+}
+
+// Next selection index when stepping the list by `dir` (+1 down / -1 up).
+// No current selection (i<0) lands on the first (down) or last (up) row;
+// otherwise clamps at the ends. Returns -1 for an empty list.
+export function nextIndex(len, i, dir) {
+  if (len <= 0) return -1;
+  if (i < 0) return dir > 0 ? 0 : len - 1;
+  return Math.max(0, Math.min(len - 1, i + dir));
+}

package/lab/ui/index.html

@@ -101,6 +101,23 @@
         color: var(--muted);
         font-size: 12.5px;
       }
+      .install {
+        margin-top: 8px;
+        color: var(--muted);
+        font-size: 11.5px;
+      }
+      .install code {
+        cursor: pointer;
+        color: var(--green);
+      }
+      .install code:hover {
+        filter: brightness(1.25);
+      }
+      @media (max-width: 720px) {
+        .install .winhint {
+          display: none;
+        }
+      }
       .ibox {
         display: flex;
         align-items: center;
@@ -604,6 +621,14 @@
           <div class="sub">
             Live <code>ay ls</code> + per-agent tail &amp; send. Backed by <code>ay serve</code>.
           </div>
+          <div class="install" title="click to copy">
+            install:
+            <code class="copy">curl -fsSL https://agent-yes.com/setup.sh | sh</code>
+            <span class="winhint"
+              >·&nbsp;Windows:
+              <code class="copy">irm https://agent-yes.com/setup.ps1 | iex</code></span
+            >
+          </div>
           <div class="ibox">
             <span class="mag">⌕</span>
             <input
@@ -650,7 +675,21 @@
     <div class="launchoverlay" id="launch" style="display: none"></div>
     <div class="launchoverlay" id="newform" style="display: none"></div>
 
-    <script>
+    <script type="module">
+      // Pure list/identity/filter helpers live in a sibling module so they can be
+      // unit-tested (tests/ui-logic/console-logic.spec.ts) without a DOM. This
+      // script is a module (deferred, runs after the codehost shim above sets
+      // window.__codehost), so a static import is safe.
+      import {
+        cliLabel,
+        repoBranch,
+        ident,
+        tagsFor,
+        age,
+        matches,
+        nextIndex,
+      } from "./console-logic.js";
+
       let entries = [];
       let sel = null; // selected keyword (pid as string)
       let es = null; // live-tail subscription closer
@@ -984,66 +1023,6 @@
         },
       };
 
-      // claude is the default CLI — show the cli name only when it differs, so the
-      // common case stays uncluttered and the identity (repo/branch) leads instead.
-      const cliLabel = (e) => (e.cli && e.cli !== "claude" ? e.cli : "");
-      // Parse owner/repo/branch from a cwd like .../ws/<owner>/<repo>/tree/<branch>.
-      function repoBranch(e) {
-        const m = /\/([^/]+)\/([^/]+)\/tree\/([^/]+)/.exec(e.cwd || "");
-        return m ? { owner: m[1], repo: m[2], branch: m[3] } : null;
-      }
-      // Identity string for the left panel. cap=true → repo/branch each clipped to
-      // 3 chars for the compact one-line view (e.g. "age/mai").
-      function ident(e, cap) {
-        const rb = repoBranch(e);
-        if (!rb) return "";
-        const c = (s) => (cap && s.length > 3 ? s.slice(0, 3) : s);
-        return `${c(rb.repo)}/${c(rb.branch)}`;
-      }
-
-      // Derive codehost-style mnemonic tags from a cwd like .../ws/<owner>/<repo>/tree/<wt>
-      function tagsFor(e) {
-        const t = [];
-        const rb = repoBranch(e);
-        if (rb) {
-          t.push(["repo", `${rb.owner}/${rb.repo}`], ["wt", rb.branch]);
-        }
-        const cli = cliLabel(e);
-        if (cli) t.push(["cli", cli]);
-        if (e._host) t.push(["host", e._host]); // codehost rooms: which machine
-        return t;
-      }
-      function age(e) {
-        if (!e.started_at) return "";
-        const s = Math.max(0, (Date.now() - e.started_at) / 1000);
-        if (s < 60) return Math.floor(s) + "s";
-        if (s < 3600) return Math.floor(s / 60) + "m";
-        return Math.floor(s / 3600) + "h";
-      }
-
-      function matches(e, toks) {
-        const hay =
-          (e.title || "") +
-          " " +
-          (e.prompt || "") +
-          " " +
-          e.cli +
-          " " +
-          (e.cwd || "") +
-          " " +
-          e.status;
-        return toks.every((tok) => {
-          tok = tok.toLowerCase();
-          const ci = tok.indexOf(":");
-          if (ci > 0) {
-            const k = tok.slice(0, ci),
-              v = tok.slice(ci + 1);
-            return tagsFor(e).some(([tk, tv]) => tk === k && tv.toLowerCase().includes(v));
-          }
-          return hay.toLowerCase().includes(tok);
-        });
-      }
-
       // Compact list: one line per agent (dot + cli + title), persisted per device.
       let compactList = localStorage.getItem("ay.compactList") === "1";
 
@@ -1244,10 +1223,8 @@
         const toks = $("q").value.trim().split(/\s+/).filter(Boolean);
         const shown = entries.filter((e) => matches(e, toks));
         if (!shown.length) return;
-        let i = shown.findIndex((e) => String(e.pid) === sel);
-        if (i < 0) i = dir > 0 ? 0 : shown.length - 1;
-        else i = Math.max(0, Math.min(shown.length - 1, i + dir));
-        const next = shown[i];
+        const cur = shown.findIndex((e) => String(e.pid) === sel);
+        const next = shown[nextIndex(shown.length, cur, dir)];
         select(String(next.pid));
         const row = $("list").querySelector('.row[data-pid="' + next.pid + '"]');
         if (row) row.scrollIntoView({ block: "nearest" });
@@ -1384,8 +1361,12 @@
           : `<div class="empty2">no saved rooms — paste a share link below</div>`;
         $("rooms").innerHTML = `<div class="rtitle">rooms · stored on this device</div>${items}
       <div class="radd"><input id="roomin" placeholder="room:token  or  https://…/#room:token" /><button id="roomadd">add</button></div>
+      <div class="rconnect">new here? install agent-yes (bun or npm, auto):
+        <code id="cmdinstall" class="copy" title="click to copy">curl -fsSL https://agent-yes.com/setup.sh | sh</code>
+        <span style="opacity:.6">Windows:</span>
+        <code id="cmdinstallwin" class="copy" title="click to copy">irm https://agent-yes.com/setup.ps1 | iex</code></div>
       <div class="rconnect">share your own fleet — run this, then open the printed link:
-        <code id="cmd" title="click to copy">bunx agent-yes serve --share</code></div>
+        <code id="cmd" class="copy" title="click to copy">ay serve share</code></div>
       <div class="rconnect">or view a <b>codehost</b> room — paste <code>ch:&lt;room-token&gt;</code> (or a
         codehost.dev share link) above; every machine in the room shows its agents here.</div>`;
       }
@@ -1421,15 +1402,20 @@
             $("rooms").style.display = "none";
           } else alert("expected  room:token  or a share link");
         }
-        if (ev.target.id === "cmd") {
-          navigator.clipboard?.writeText(ev.target.textContent).then(() => {
-            const o = ev.target.textContent;
-            ev.target.textContent = "copied ✓";
-            setTimeout(() => {
-              ev.target.textContent = o;
-            }, 1000);
-          });
-        }
+      });
+
+      // Click-to-copy for any <code class="copy"> (install one-liners, share cmd…),
+      // wherever it lives — header or the rooms panel.
+      document.addEventListener("click", (ev) => {
+        const c = ev.target.closest && ev.target.closest("code.copy");
+        if (!c) return;
+        navigator.clipboard?.writeText(c.textContent).then(() => {
+          const o = c.textContent;
+          c.textContent = "copied ✓";
+          setTimeout(() => {
+            c.textContent = o;
+          }, 1000);
+        });
       });
 
       // ---- launch: command-only URLs (#launch=<json>, NO token) ----

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-yes",
-  "version": "1.101.0",
+  "version": "1.103.0",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",
@@ -55,6 +55,7 @@
     "ts/*.ts",
     "!dist/**/*.map",
     "dist/**/*.js",
+    "lab/ui/console-logic.js",
     "lab/ui/index.html",
     "lab/ui/room-client.js"
   ],
@@ -86,7 +87,8 @@
     "release:beta": "standard-version && npm publish --tag beta",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "test:ui": "vitest run --config tests/ui-test/vitest.config.ts"
+    "test:ui": "vitest run --config tests/ui-test/vitest.config.ts",
+    "test:ui-dom": "vitest run --config tests/ui-dom/vitest.config.ts"
   },
   "dependencies": {
     "@snomiao/bun-pty": "^0.3.4",

package/ts/serve.ts

@@ -620,6 +620,8 @@ export async function cmdServe(rest: string[]): Promise<number> {
       return serveUiFile("index.html", "text/html; charset=utf-8");
     if (req.method === "GET" && p === "/room-client.js")
       return serveUiFile("room-client.js", "text/javascript; charset=utf-8");
+    if (req.method === "GET" && p === "/console-logic.js")
+      return serveUiFile("console-logic.js", "text/javascript; charset=utf-8");
     if (req.method === "GET" && p === "/favicon.ico") return new Response(null, { status: 204 });
     return apiFetch(req);
   };

package/ts/workspaceConfig.spec.ts

@@ -0,0 +1,71 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { mkdtempSync, rmSync } from "fs";
+import { homedir, tmpdir } from "os";
+import path from "path";
+import {
+  expandTilde,
+  getWorkspaceRoot,
+  resolveSpawnCwd,
+  setWorkspaceRoot,
+} from "./workspaceConfig.ts";
+
+describe("workspaceConfig", () => {
+  let original: string | undefined;
+  let tmp: string;
+  beforeEach(() => {
+    original = process.env.AGENT_YES_HOME;
+    tmp = mkdtempSync(path.join(tmpdir(), "ay-cfg-"));
+    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("defaults the workspace root to the home dir when unset", () => {
+    expect(getWorkspaceRoot()).toBe(homedir());
+  });
+
+  it("round-trips set/get and resolves to an absolute path", () => {
+    const saved = setWorkspaceRoot(path.join(tmp, "ws"));
+    expect(saved).toBe(path.join(tmp, "ws"));
+    expect(getWorkspaceRoot()).toBe(path.join(tmp, "ws"));
+  });
+
+  it("expands a leading ~", () => {
+    expect(expandTilde("~")).toBe(homedir());
+    expect(expandTilde("~/projects")).toBe(path.join(homedir(), "projects"));
+    expect(expandTilde("/abs/path")).toBe("/abs/path");
+  });
+
+  it("stores a tilde path as home-based absolute", () => {
+    const saved = setWorkspaceRoot("~/myws");
+    expect(saved).toBe(path.join(homedir(), "myws"));
+  });
+
+  describe("resolveSpawnCwd", () => {
+    beforeEach(() => setWorkspaceRoot(path.join(tmp, "ws")));
+
+    it("empty input → workspace root", () => {
+      expect(resolveSpawnCwd("")).toBe(path.join(tmp, "ws"));
+      expect(resolveSpawnCwd(undefined)).toBe(path.join(tmp, "ws"));
+    });
+
+    it("bare name → <workspace>/<name>", () => {
+      expect(resolveSpawnCwd("myproject")).toBe(path.join(tmp, "ws", "myproject"));
+    });
+
+    it("absolute path → used as-is", () => {
+      expect(resolveSpawnCwd("/tmp/elsewhere")).toBe("/tmp/elsewhere");
+    });
+
+    it("tilde path → home-based", () => {
+      expect(resolveSpawnCwd("~/docs")).toBe(path.join(homedir(), "docs"));
+    });
+
+    it("a relative path with a separator is resolved, not joined to the workspace", () => {
+      expect(resolveSpawnCwd("a/b")).toBe(path.resolve("a/b"));
+    });
+  });
+});

package/ts/workspaceConfig.ts

@@ -0,0 +1,70 @@
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import path from "path";
+import { agentYesHome } from "./agentYesHome.ts";
+
+/**
+ * Machine-global agent-yes config (workspace root, etc.), stored alongside the
+ * pid index and serve token under `agentYesHome()`. Kept tiny and synchronous —
+ * it's read on the spawn hot path and written once during `ay setup`.
+ *
+ * The *workspace root* is the default directory new agents are spawned into when
+ * the console doesn't pass an explicit cwd. It defaults to the user's home dir so
+ * a non-engineer can just run agents in their files without knowing about paths.
+ */
+
+interface Config {
+  workspace?: string;
+}
+
+function configPath(): string {
+  return path.join(agentYesHome(), "config.json");
+}
+
+function readConfig(): Config {
+  try {
+    return JSON.parse(readFileSync(configPath(), "utf-8")) as Config;
+  } catch {
+    return {};
+  }
+}
+
+/** Expand a leading `~` (`~` or `~/x`) to an absolute home-based path. */
+export function expandTilde(p: string): string {
+  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. */
+export function getWorkspaceRoot(): string {
+  const w = readConfig().workspace;
+  return w && w.trim() ? w : homedir();
+}
+
+/** Persist the workspace root, tilde-expanded and resolved to an absolute path. */
+export function setWorkspaceRoot(dir: string): string {
+  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;
+}
+
+/**
+ * Resolve a user-supplied spawn location to an absolute cwd:
+ * - empty            → the workspace root
+ * - a bare name      → `<workspace>/<name>` (so "myproject" lands under the root)
+ * - `~`-prefixed     → home-based absolute
+ * - anything with a path separator → resolved as-is
+ */
+export function resolveSpawnCwd(input?: string): string {
+  const root = getWorkspaceRoot();
+  const v = (input ?? "").trim();
+  if (!v) return root;
+  if (v.startsWith("~")) return path.resolve(expandTilde(v));
+  if (v.includes("/") || v.includes("\\") || path.isAbsolute(v)) return path.resolve(v);
+  return path.join(root, v);
+}

package/dist/SUPPORTED_CLIS-DGQZ0sRr.js

@@ -1,8 +0,0 @@
-import "./ts-mo_bB4au.js";
-import "./logger-B9h0djqx.js";
-import "./versionChecker-BhU9-zSi.js";
-import "./pidStore-DBjlqzo8.js";
-import "./globalPidIndex-yVd3mbsV.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CXsHRSdB.js";
-
-export { SUPPORTED_CLIS };