claude-yes 1.82.0 → 1.84.0

package/dist/{SUPPORTED_CLIS-WKiG4dyQ.js → SUPPORTED_CLIS-DM0fJTMR.js}

@@ -1,6 +1,6 @@
-import { t as CLIS_CONFIG } from "./ts-WV8trEPX.js";
+import { t as CLIS_CONFIG } from "./ts-Bw6gQKyU.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-BVt2a2mL.js";
+import "./versionChecker-CspuhOwO.js";
 import "./pidStore-C1JXxoPi.js";
 import "./globalPidIndex-Cr-g75QF.js";
 
@@ -9,4 +9,4 @@ const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS };
-//# sourceMappingURL=SUPPORTED_CLIS-WKiG4dyQ.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-DM0fJTMR.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-BVt2a2mL.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-CspuhOwO.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -42,6 +42,10 @@ function parseCliArgs(argv, supportedClis) {
 		type: "boolean",
 		description: "Prepend SKILL.md header from current directory to the prompt (helpful for non-Claude agents)",
 		default: false
+	}).option("swarm-hint", {
+		type: "boolean",
+		description: "Inject peer discovery hint into agent system prompt when other agents are running (use --no-swarm-hint to opt out)",
+		default: true
 	}).option("timeout", {
 		type: "string",
 		description: "Exit after a period of inactivity, e.g., \"5s\" or \"1m\"",
@@ -221,6 +225,7 @@ function parseCliArgs(argv, supportedClis) {
 		verbose: parsedArgv.verbose,
 		resume: parsedArgv.continue,
 		useSkills: parsedArgv.useSkills,
+		swarmHint: parsedArgv.swarmHint,
 		appendPrompt: parsedArgv.appendPrompt,
 		useStdinAppend: Boolean(parsedArgv.stdpush || parsedArgv.ipc || parsedArgv.fifo),
 		showVersion: parsedArgv.version,
@@ -475,7 +480,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 	}
 }
 {
-	const { isSubcommand, runSubcommand } = await import("./subcommands-eMrWDGMq.js");
+	const { isSubcommand, runSubcommand } = await import("./subcommands-DjO8lthH.js");
 	if (isSubcommand(process.argv[2])) {
 		const code = await runSubcommand(process.argv);
 		process.exit(code ?? 0);
@@ -504,7 +509,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-WKiG4dyQ.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-DM0fJTMR.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-WV8trEPX.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-Bw6gQKyU.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-BVt2a2mL.js";
+import "./versionChecker-CspuhOwO.js";
 import "./pidStore-C1JXxoPi.js";
 import "./globalPidIndex-Cr-g75QF.js";
 

package/dist/{subcommands-eMrWDGMq.js → subcommands-DjO8lthH.js}

@@ -1,12 +1,12 @@
 import "./logger-B9h0djqx.js";
 import { r as readGlobalPids } from "./globalPidIndex-Cr-g75QF.js";
-import { appendFile, mkdir, readFile, stat, writeFile } from "fs/promises";
+import { appendFile, mkdir, open, readFile, stat, writeFile } from "fs/promises";
 import { homedir } from "os";
 import path from "path";
 
 //#region ts/subcommands.ts
 /**
-* `cy ls / read / cat / tail / head / send` subcommand implementations.
+* `ay ls / read / cat / tail / head / send` subcommand implementations.
 *
 * Mirrors the principles of koho's `terminal-ws-lib.ts` (session list, render
 * via @xterm/headless, keyword-keyed input) — but file-based instead of via
@@ -61,7 +61,7 @@ async function compactNotes() {
 /**
 * Read the per-cwd TS PidStore JSONL and convert to the global record shape,
 * so pre-existing TS agents that were spawned before the global-index mirror
-* shipped still show up in `cy ls`. Merging is done in `mergeRecords`.
+* shipped still show up in `ay ls`. Merging is done in `mergeRecords`.
 */
 async function readLocalTsPids(cwd) {
 	const jsonlPath = path.join(cwd, ".agent-yes", "pid-records.jsonl");
@@ -118,6 +118,7 @@ const SUBCOMMANDS = new Set([
 	"ls",
 	"list",
 	"ps",
+	"status",
 	"read",
 	"cat",
 	"tail",
@@ -126,6 +127,7 @@ const SUBCOMMANDS = new Set([
 	"restart",
 	"note"
 ]);
+const IDLE_THRESHOLD_MS = 60 * 1e3;
 function isSubcommand(name) {
 	return !!name && SUBCOMMANDS.has(name);
 }
@@ -142,6 +144,7 @@ async function runSubcommand(argv) {
 			case "ls":
 			case "list":
 			case "ps": return await cmdLs(rest);
+			case "status": return await cmdStatus(rest);
 			case "read":
 			case "cat": return await cmdRead(rest, { mode: "cat" });
 			case "tail": return await cmdRead(rest, { mode: "tail" });
@@ -153,7 +156,7 @@ async function runSubcommand(argv) {
 		}
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : String(err);
-		process.stderr.write(`cy ${sub}: ${msg}\n`);
+		process.stderr.write(`ay ${sub}: ${msg}\n`);
 		return 1;
 	}
 }
@@ -173,7 +176,8 @@ function parseArgs(rest) {
 					"active",
 					"follow",
 					"json",
-					"latest"
+					"latest",
+					"watch"
 				].includes(key) || !next || next.startsWith("-")) flags[key] = true;
 				else {
 					flags[key] = next;
@@ -262,7 +266,6 @@ async function cmdLs(rest) {
 	};
 	const fixedWidth = widths.pid + widths.cli + widths.status + widths.age + widths.cwd + 10;
 	const promptBudget = Math.max(20, termWidth - fixedWidth - 1);
-	const IDLE_THRESHOLD_MS = 60 * 1e3;
 	const notes = await readNotes();
 	const rows = await Promise.all(records.map(async (r) => {
 		let displayStatus;
@@ -271,8 +274,14 @@ async function cmdLs(rest) {
 			const mtime = await stat(r.log_file).then((s) => s.mtimeMs).catch(() => null);
 			displayStatus = mtime !== null && Date.now() - mtime > IDLE_THRESHOLD_MS ? "idle" : "active";
 		} else displayStatus = "active";
-		const label = truncate(notes.get(r.pid) ?? r.prompt ?? "", promptBudget);
-		const hasNote = notes.has(r.pid);
+		const note = notes.get(r.pid);
+		let label;
+		let hasNote = false;
+		if (note) {
+			label = truncate(note, promptBudget);
+			hasNote = true;
+		} else if (r.log_file && displayStatus !== "stopped") label = truncate(await extractActivity(r.log_file) ?? (r.prompt ? `→ ${r.prompt}` : ""), promptBudget);
+		else label = truncate(r.prompt ? `→ ${r.prompt}` : "", promptBudget);
 		return {
 			pid: String(r.pid),
 			cli: r.cli,
@@ -306,14 +315,17 @@ async function cmdLs(rest) {
 		const stopped = rows.find((r) => !r._alive);
 		const hints = ["\n"];
 		if (alive) {
-			hints.push(`  cy tail ${alive.pid}                  # view latest output\n`);
-			hints.push(`  cy tail -f ${alive.pid}               # follow live output\n`);
-			hints.push(`  cy send ${alive.pid} "next: ..."      # send a prompt\n`);
-			hints.push(`  cy send ${alive.pid} "" --code=ctrl-c # interrupt\n`);
-			hints.push(`  cy note ${alive.pid} "what it's doing" # set a note\n`);
+			hints.push(`  ay status ${alive.pid}                # JSON status snapshot\n`);
+			hints.push(`  ay status ${alive.pid} --watch        # stream changes as JSON\n`);
+			hints.push(`  ay tail ${alive.pid}                  # view latest output\n`);
+			hints.push(`  ay tail -f ${alive.pid}               # follow live output\n`);
+			hints.push(`  ay send ${alive.pid} "next: ..."      # send a prompt (keyword: pid, cwd, or prompt substring)\n`);
+			hints.push(`  ay send ${alive.pid} "" --code=ctrl-c # interrupt\n`);
+			hints.push(`  ay note ${alive.pid} "what it's doing" # set a note\n`);
+			hints.push(`  ay ls --json                           # machine-readable list for scripts/agents\n`);
 		}
-		if (stopped) hints.push(`  cy restart ${stopped.pid}             # restart stopped agent\n`);
-		if (!alive && !stopped) hints.push(`  cy ls --all                          # show exited agents\n`);
+		if (stopped) hints.push(`  ay restart ${stopped.pid}             # restart stopped agent\n`);
+		if (!alive && !stopped) hints.push(`  ay ls --all                          # show exited agents\n`);
 		process.stderr.write(hints.join(""));
 	}
 	return 0;
@@ -386,8 +398,8 @@ async function cmdRead(rest, { mode }) {
 		return 0;
 	}
 	process.stderr.write(`
-  cy ls                                 # list all agents
-  cy tail -f ${record.pid}              # follow live output\n  cy send ${record.pid} "next: ..."      # send a prompt\n  cy send ${record.pid} "" --code=ctrl-c # interrupt\n`);
+  ay ls                                 # list all agents
+  ay tail -f ${record.pid}              # follow live output\n  ay send ${record.pid} "next: ..."      # send a prompt\n  ay send ${record.pid} "" --code=ctrl-c # interrupt\n`);
 	return 0;
 }
 /**
@@ -426,12 +438,85 @@ async function renderRawLog(buf, { mode, n }) {
 		return lines.slice(0, n).join("\n");
 	}
 }
+/**
+* Extract a one-line activity summary from a raw log file.
+* Reads only the last 32 KB for speed, renders via xterm for clean output.
+*/
+async function extractActivity(logPath) {
+	const TAIL_BYTES = 32 * 1024;
+	let buf;
+	try {
+		const fh = await open(logPath, "r");
+		try {
+			const { size } = await fh.stat();
+			if (size === 0) return null;
+			if (size <= TAIL_BYTES) {
+				const data = await fh.readFile();
+				buf = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+			} else {
+				const tmp = Buffer.alloc(TAIL_BYTES);
+				const { bytesRead } = await fh.read(tmp, 0, TAIL_BYTES, size - TAIL_BYTES);
+				buf = new Uint8Array(tmp.buffer, 0, bytesRead);
+			}
+		} finally {
+			await fh.close();
+		}
+	} catch {
+		return null;
+	}
+	try {
+		return extractActivityFromLines((await renderRawLog(buf, {
+			mode: "tail",
+			n: 40
+		})).split("\n"));
+	} catch {
+		return null;
+	}
+}
+function extractActivityFromLines(lines) {
+	const isChrome = (l) => {
+		const s = l.trim();
+		return !s || /^─+$/.test(s) || s.startsWith("? for shortcuts") || /^esc to interrupt/i.test(s) || /\d+%\s*until auto-compact/i.test(s) || /^\/model\s+/i.test(s) || /^⧉\s+In\s+/i.test(s) || /^●\s+(high|medium|low)\s*[·•]/i.test(s) || /^[·•]\s*\d+\s+(left|request)/i.test(s);
+	};
+	const clean = lines.filter((l) => !isChrome(l));
+	const isSpinnerLine = (l) => /^[^\w\s❯>⎿✓✗]\s+[A-Z]\w+[….]/u.test(l.trim()) || /still thinking/i.test(l);
+	let lastPromptIdx = -1;
+	let lastSpinnerIdx = -1;
+	for (let i = clean.length - 1; i >= 0; i--) {
+		const l = clean[i].trim();
+		if (lastPromptIdx === -1 && l.startsWith("❯")) lastPromptIdx = i;
+		if (lastSpinnerIdx === -1 && isSpinnerLine(l)) lastSpinnerIdx = i;
+		if (lastPromptIdx !== -1 && lastSpinnerIdx !== -1) break;
+	}
+	if (lastPromptIdx > lastSpinnerIdx) {
+		const text = clean[lastPromptIdx].trim().replace(/^❯\s*/, "").trim();
+		return text ? `» ${text}` : null;
+	}
+	const thinkingLine = clean.find((l) => isSpinnerLine(l));
+	if (thinkingLine) {
+		const m = /^.\s+(\w+[^(]*)(?:\s*\(|$)/u.exec(thinkingLine.trim());
+		return m?.[1] ? `✳ ${m[1].trim()}` : "thinking…";
+	}
+	const cookIdx = clean.findIndex((l) => /^✻\s+/.test(l.trim()));
+	if (cookIdx >= 0) {
+		const window = clean.slice(Math.max(0, cookIdx - 8), cookIdx);
+		for (let i = window.length - 1; i >= 0; i--) {
+			const l = window[i].trim();
+			if (l && !/^[✻✢⧉❯]/.test(l) && !isChrome(l)) return l.length > 80 ? l.slice(0, 79) + "…" : l;
+		}
+	}
+	for (let i = clean.length - 1; i >= 0; i--) {
+		const l = clean[i].trim();
+		if (l && !/^[─●○◉⧉]/.test(l) && !/^[^\w\s❯>]\s+[A-Z]\w+[….]/u.test(l)) return l.length > 80 ? l.slice(0, 79) + "…" : l;
+	}
+	return null;
+}
 async function cmdSend(rest) {
 	const { flags, positional } = parseArgs(rest);
 	const opts = commonOpts(flags);
 	const keyword = positional[0];
 	const rawMessage = positional.slice(1).join(" ");
-	if (!keyword) throw new Error("usage: cy send <keyword> <msg|-> [--code=enter|esc|ctrl-c|ctrl-y|tab|none]");
+	if (!keyword) throw new Error("usage: ay send <keyword> <msg|-> [--code=enter|esc|ctrl-c|ctrl-y|tab|none]");
 	const trailing = controlCodeFromName(typeof flags.code === "string" ? flags.code.toLowerCase() : "enter");
 	const record = await resolveOne(keyword, opts);
 	const fifoPath = record.fifo_file;
@@ -442,14 +527,18 @@ async function cmdSend(rest) {
 		for await (const chunk of process.stdin) chunks.push(chunk);
 		body = Buffer.concat(chunks).toString("utf-8").trimEnd();
 	} else body = rawMessage;
-	if (body && trailing) {
-		await writeToIpc(fifoPath, body);
+	const sourcePid = process.env.AGENT_YES_PID ? Number(process.env.AGENT_YES_PID) : null;
+	const talkBack = sourcePid ? `\n(from AGENT_YES_PID=${sourcePid} — reply: ay send ${sourcePid} "...")` : "";
+	const fullBody = body + talkBack;
+	if (fullBody && trailing) {
+		await writeToIpc(fifoPath, fullBody);
 		await new Promise((r) => setTimeout(r, 200));
 		await writeToIpc(fifoPath, trailing);
-	} else await writeToIpc(fifoPath, body + trailing);
+	} else await writeToIpc(fifoPath, fullBody + trailing);
 	const payload = body + trailing;
 	process.stdout.write(`sent to pid ${record.pid} (${record.cli}): ${truncate(payload, 80)}\n`);
-	process.stderr.write(`\n  cy tail ${record.pid}                  # watch output\n  cy ls                                  # list all agents\n`);
+	const replyHint = sourcePid ? `  ay send ${sourcePid} "..."              # reply to sender\n` : "";
+	process.stderr.write(`\n` + replyHint + `  ay tail ${record.pid}                  # watch output\n  ay ls                                  # list all agents\n`);
 	return 0;
 }
 function controlCodeFromName(name) {
@@ -513,7 +602,7 @@ async function cmdRestart(rest) {
 	const keyword = positional[0];
 	const record = await resolveOne(keyword, opts);
 	if (isPidAlive(record.pid)) {
-		process.stderr.write(`pid ${record.pid} is still running — stop it first or use cy send\n`);
+		process.stderr.write(`pid ${record.pid} is still running — stop it first or use ay send\n`);
 		return 1;
 	}
 	const args = ["--cli=" + record.cli];
@@ -528,7 +617,7 @@ async function cmdRestart(rest) {
 		]
 	});
 	process.stdout.write(`restarted ${record.cli} in ${shortenPath(record.cwd)} (new pid: ${proc.pid})\n`);
-	process.stderr.write(`\n  cy tail ${proc.pid}   # watch output\n  cy ls                 # list all agents\n`);
+	process.stderr.write(`\n  ay tail ${proc.pid}   # watch output\n  ay ls                 # list all agents\n`);
 	return 0;
 }
 async function cmdNote(rest) {
@@ -536,7 +625,7 @@ async function cmdNote(rest) {
 	const opts = commonOpts(flags);
 	const keyword = positional[0];
 	const note = positional.slice(1).join(" ");
-	if (!keyword) throw new Error("usage: cy note <keyword> [\"note text\"]  (omit text to clear)");
+	if (!keyword) throw new Error("usage: ay note <keyword> [\"note text\"]  (omit text to clear)");
 	const record = await resolveOne(keyword, {
 		...opts,
 		all: true
@@ -549,10 +638,82 @@ async function cmdNote(rest) {
 	}
 	await writeNote(record.pid, note);
 	process.stdout.write(`note set for pid ${record.pid}: ${note}\n`);
-	process.stderr.write(`\n  cy ls   # see updated note in list\n`);
+	process.stderr.write(`\n  ay ls   # see updated note in list\n`);
+	return 0;
+}
+async function snapshotStatus(record) {
+	const alive = isPidAlive(record.pid);
+	let state;
+	let logMtimeMs = null;
+	if (!alive) state = "stopped";
+	else if (record.log_file) {
+		logMtimeMs = await stat(record.log_file).then((s) => s.mtimeMs).catch(() => null);
+		state = logMtimeMs !== null && Date.now() - logMtimeMs > IDLE_THRESHOLD_MS ? "idle" : "active";
+	} else state = "active";
+	const activity = state !== "stopped" && record.log_file ? await extractActivity(record.log_file) : null;
+	const note = (await readNotes()).get(record.pid) ?? null;
+	return {
+		pid: record.pid,
+		cli: record.cli,
+		cwd: record.cwd,
+		state,
+		activity,
+		note,
+		log_mtime_ms: logMtimeMs,
+		started_at: record.started_at,
+		age_ms: Date.now() - record.started_at,
+		exit_code: record.exit_code,
+		exit_reason: record.exit_reason,
+		log_file: record.log_file ?? null
+	};
+}
+async function cmdStatus(rest) {
+	const { flags, positional } = parseArgs(rest);
+	const opts = {
+		...commonOpts(flags),
+		all: true
+	};
+	const keyword = positional[0];
+	if (!keyword) throw new Error("usage: ay status <keyword> [--watch] [--interval=N]");
+	const watch = !!(flags.watch || flags.w);
+	const intervalFlag = typeof flags.interval === "string" ? Number(flags.interval) : 2;
+	const intervalMs = Math.max(500, (Number.isFinite(intervalFlag) ? intervalFlag : 2) * 1e3);
+	const record = await resolveOne(keyword, opts);
+	const emit = (snap, ts) => {
+		const out = ts !== void 0 ? {
+			ts,
+			...snap
+		} : snap;
+		process.stdout.write(JSON.stringify(out) + "\n");
+	};
+	if (!watch) {
+		emit(await snapshotStatus(record));
+		return 0;
+	}
+	process.stderr.write(`watching pid ${record.pid} every ${intervalMs / 1e3}s… (Ctrl-C to stop)\n`);
+	let prev = null;
+	const tick = async () => {
+		const snap = await snapshotStatus(record);
+		if (prev === null || snap.state !== prev.state || snap.activity !== prev.activity || snap.exit_code !== prev.exit_code) {
+			emit(snap, Date.now());
+			prev = {
+				state: snap.state,
+				activity: snap.activity,
+				exit_code: snap.exit_code
+			};
+		}
+	};
+	await tick();
+	await new Promise((resolve) => {
+		const timer = setInterval(tick, intervalMs);
+		process.on("SIGINT", () => {
+			clearInterval(timer);
+			resolve();
+		});
+	});
 	return 0;
 }
 
 //#endregion
 export { isSubcommand, runSubcommand };
-//# sourceMappingURL=subcommands-eMrWDGMq.js.map
+//# sourceMappingURL=subcommands-DjO8lthH.js.map

package/dist/{ts-WV8trEPX.js → ts-Bw6gQKyU.js}

@@ -1,7 +1,8 @@
 import { n as logger, t as addTransport } from "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-BVt2a2mL.js";
+import { r as getInstalledPackage } from "./versionChecker-CspuhOwO.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-C22d9SRJ.js";
 import { t as PidStore } from "./pidStore-C1JXxoPi.js";
+import { r as readGlobalPids } from "./globalPidIndex-Cr-g75QF.js";
 import { arch, platform } from "process";
 import { execSync } from "child_process";
 import { closeSync, constants, createReadStream, existsSync, mkdirSync, openSync } from "fs";
@@ -1062,7 +1063,7 @@ const CLIS_CONFIG = config.clis;
 * });
 * ```
 */
-async function agentYes({ cli, cliArgs = [], prompt, robust = true, cwd, env, exitOnIdle, logFile, removeControlCharactersFromStdout = false, verbose = false, queue = false, install = false, resume = false, useSkills = false, useStdinAppend = false, autoYes = true, idleAction }) {
+async function agentYes({ cli, cliArgs = [], prompt, robust = true, cwd, env, exitOnIdle, logFile, removeControlCharactersFromStdout = false, verbose = false, queue = false, install = false, resume = false, useSkills = false, useStdinAppend = false, autoYes = true, idleAction, swarmHint = true }) {
 	if (!cli) throw new Error(`cli is required`);
 	const conf = CLIS_CONFIG[cli] || DIE(`Unsupported cli tool: ${cli}, current process.argv: ${process.argv.join(" ")}`);
 	const workingDir = cwd ?? process.cwd();
@@ -1139,6 +1140,18 @@ async function agentYes({ cli, cliArgs = [], prompt, robust = true, cwd, env, ex
 	} catch (error) {
 		if (verbose) logger.warn("[skills] Failed to inject SKILL.md header:", { error });
 	}
+	if (swarmHint) try {
+		const peers = await readGlobalPids({ liveOnly: true });
+		if (peers.length > 0) {
+			const hint = `${peers.length} peer agent${peers.length > 1 ? "s are" : " is"} running. Before asking the user for input on any domain-specific topic (design, testing, architecture, etc.), check for relevant peers first: \`ay ls --json\` (see \`prompt\` field for their role). Ask one: \`ay send <pid> <question>\`. Read reply: \`ay tail <pid>\`. Do not use interactive forms or user prompts when a peer can answer.`;
+			if (cli === "claude") cliArgs = [
+				"--append-system-prompt",
+				hint,
+				...cliArgs
+			];
+			prompt = prompt ? `[${hint}]\n\n${prompt}` : hint;
+		}
+	} catch {}
 	if (resume) if (cli === "codex" && resume) {
 		const storedSessionId = await getSessionForCwd(workingDir);
 		if (storedSessionId) {
@@ -1171,6 +1184,7 @@ async function agentYes({ cli, cliArgs = [], prompt, robust = true, cwd, env, ex
 		prompt = void 0;
 	} else logger.warn(`Unknown promptArg format: ${cliConf.promptArg}`);
 	const ptyEnv = { ...env ?? process.env };
+	ptyEnv.AGENT_YES_PID = String(process.pid);
 	const ptyOptions = {
 		name: "xterm-color",
 		...getTerminalDimensions(),
@@ -1679,4 +1693,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-WV8trEPX.js.map
+//# sourceMappingURL=ts-Bw6gQKyU.js.map

package/dist/{versionChecker-BVt2a2mL.js → versionChecker-CspuhOwO.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "claude-yes";
-var version = "1.82.0";
+var version = "1.84.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-BVt2a2mL.js.map
+//# sourceMappingURL=versionChecker-CspuhOwO.js.map

package/package.json

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

package/ts/index.ts

@@ -28,6 +28,7 @@ import { AgentContext } from "./core/context.ts";
 import { createTerminatorStream } from "./core/streamHelpers.ts";
 import { globalAgentRegistry } from "./agentRegistry.ts";
 import { notifyWebhook } from "./webhookNotifier.ts";
+import { readGlobalPids } from "./globalPidIndex.ts";
 
 export { removeControlCharacters };
 export { AgentContext };
@@ -124,6 +125,7 @@ export default async function agentYes({
   useStdinAppend = false,
   autoYes = true,
   idleAction,
+  swarmHint = true,
 }: {
   cli: keyof typeof CLIS_CONFIG;
   cliArgs?: string[];
@@ -142,6 +144,7 @@ export default async function agentYes({
   useStdinAppend?: boolean; // if true, enable FIFO input stream on Linux,  for additional stdin input
   autoYes?: boolean; // if true, auto-yes is enabled (default), toggle with Ctrl+Y during session
   idleAction?: string; // if set, type this message when idle instead of exiting
+  swarmHint?: boolean; // if true (default), inject peer discovery hint when other agents are running; --no-swarm-hint to opt out
 }) {
   if (!cli) throw new Error(`cli is required`);
   const conf =
@@ -274,6 +277,23 @@ export default async function agentYes({
     if (verbose) logger.warn("[skills] Failed to inject SKILL.md header:", { error });
   }
 
+  // Inject peer discovery hint when other agents are running
+  if (swarmHint) {
+    try {
+      const peers = await readGlobalPids({ liveOnly: true });
+      if (peers.length > 0) {
+        const hint = `${peers.length} peer agent${peers.length > 1 ? "s are" : " is"} running. Before asking the user for input on any domain-specific topic (design, testing, architecture, etc.), check for relevant peers first: \`ay ls --json\` (see \`prompt\` field for their role). Ask one: \`ay send <pid> <question>\`. Read reply: \`ay tail <pid>\`. Do not use interactive forms or user prompts when a peer can answer.`;
+        if (cli === "claude") {
+          cliArgs = ["--append-system-prompt", hint, ...cliArgs];
+        }
+        // Prepend to prompt for all CLIs (including claude) so it's read before the task
+        prompt = prompt ? `[${hint}]\n\n${prompt}` : hint;
+      }
+    } catch {
+      // Non-fatal
+    }
+  }
+
   // Handle --continue flag for codex session restoration
   if (resume) {
     if (cli === "codex" && resume) {
@@ -322,6 +342,7 @@ export default async function agentYes({
 
   // Spawn the agent CLI process
   const ptyEnv = { ...(env ?? (process.env as Record<string, string>)) };
+  ptyEnv.AGENT_YES_PID = String(process.pid);
   const ptyOptions = {
     name: "xterm-color",
     ...getTerminalDimensions(),

package/ts/parseCliArgs.ts

@@ -63,6 +63,12 @@ export function parseCliArgs(argv: string[], supportedClis?: readonly string[])
         "Prepend SKILL.md header from current directory to the prompt (helpful for non-Claude agents)",
       default: false,
     })
+    .option("swarm-hint", {
+      type: "boolean",
+      description:
+        "Inject peer discovery hint into agent system prompt when other agents are running (use --no-swarm-hint to opt out)",
+      default: true,
+    })
     .option("timeout", {
       type: "string",
       description: 'Exit after a period of inactivity, e.g., "5s" or "1m"',
@@ -313,6 +319,7 @@ export function parseCliArgs(argv: string[], supportedClis?: readonly string[])
     verbose: parsedArgv.verbose,
     resume: parsedArgv.continue, // Note: intentional use resume here to avoid preserved keyword (continue)
     useSkills: parsedArgv.useSkills,
+    swarmHint: parsedArgv.swarmHint,
     appendPrompt: parsedArgv.appendPrompt,
     useStdinAppend: Boolean(parsedArgv.stdpush || parsedArgv.ipc || parsedArgv.fifo), // Support --stdpush, --ipc, and --fifo (backward compatibility)
     showVersion: parsedArgv.version,

package/ts/subcommands.ts

@@ -1,5 +1,5 @@
 /**
- * `cy ls / read / cat / tail / head / send` subcommand implementations.
+ * `ay ls / read / cat / tail / head / send` subcommand implementations.
  *
  * Mirrors the principles of koho's `terminal-ws-lib.ts` (session list, render
  * via @xterm/headless, keyword-keyed input) — but file-based instead of via
@@ -11,7 +11,7 @@
  * to the normal agent-spawning flow.
  */
 
-import { appendFile, mkdir, readFile, stat, writeFile } from "fs/promises";
+import { appendFile, mkdir, open, readFile, stat, writeFile } from "fs/promises";
 import { homedir } from "os";
 import path from "path";
 import { type GlobalPidRecord, readGlobalPids } from "./globalPidIndex.ts";
@@ -66,7 +66,7 @@ async function compactNotes(): Promise<void> {
 /**
  * Read the per-cwd TS PidStore JSONL and convert to the global record shape,
  * so pre-existing TS agents that were spawned before the global-index mirror
- * shipped still show up in `cy ls`. Merging is done in `mergeRecords`.
+ * shipped still show up in `ay ls`. Merging is done in `mergeRecords`.
  */
 async function readLocalTsPids(cwd: string): Promise<GlobalPidRecord[]> {
   const jsonlPath = path.join(cwd, ".agent-yes", "pid-records.jsonl");
@@ -127,6 +127,7 @@ const SUBCOMMANDS = new Set([
   "ls",
   "list",
   "ps",
+  "status",
   "read",
   "cat",
   "tail",
@@ -136,6 +137,8 @@ const SUBCOMMANDS = new Set([
   "note",
 ]);
 
+const IDLE_THRESHOLD_MS = 60 * 1000;
+
 export function isSubcommand(name: string | undefined): boolean {
   return !!name && SUBCOMMANDS.has(name);
 }
@@ -156,6 +159,8 @@ export async function runSubcommand(argv: string[]): Promise<number | null> {
       case "list":
       case "ps":
         return await cmdLs(rest);
+      case "status":
+        return await cmdStatus(rest);
       case "read":
       case "cat":
         return await cmdRead(rest, { mode: "cat" });
@@ -174,7 +179,7 @@ export async function runSubcommand(argv: string[]): Promise<number | null> {
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`cy ${sub}: ${msg}\n`);
+    process.stderr.write(`ay ${sub}: ${msg}\n`);
     return 1;
   }
 }
@@ -210,7 +215,7 @@ export function parseArgs(rest: string[]): ParsedArgs {
         const next = rest[i + 1];
         // Boolean flags: --all, --json, --latest
         if (
-          ["all", "active", "follow", "json", "latest"].includes(key) ||
+          ["all", "active", "follow", "json", "latest", "watch"].includes(key) ||
           !next ||
           next.startsWith("-")
         ) {
@@ -322,7 +327,7 @@ async function resolveOne(keyword: string | undefined, opts: CommonOpts): Promis
 }
 
 // ---------------------------------------------------------------------------
-// cy ls
+// ay ls
 // ---------------------------------------------------------------------------
 
 async function cmdLs(rest: string[]): Promise<number> {
@@ -359,7 +364,6 @@ async function cmdLs(rest: string[]): Promise<number> {
   const fixedWidth = widths.pid + widths.cli + widths.status + widths.age + widths.cwd + 5 * 2; // 5 separators of "  "
   const promptBudget = Math.max(20, termWidth - fixedWidth - 1);
 
-  const IDLE_THRESHOLD_MS = 60 * 1000;
   const notes = await readNotes();
   const rows = await Promise.all(
     records.map(async (r) => {
@@ -375,8 +379,18 @@ async function cmdLs(rest: string[]): Promise<number> {
       } else {
         displayStatus = "active";
       }
-      const label = truncate(notes.get(r.pid) ?? r.prompt ?? "", promptBudget);
-      const hasNote = notes.has(r.pid);
+      const note = notes.get(r.pid);
+      let label: string;
+      let hasNote = false;
+      if (note) {
+        label = truncate(note, promptBudget);
+        hasNote = true;
+      } else if (r.log_file && displayStatus !== "stopped") {
+        const activity = await extractActivity(r.log_file);
+        label = truncate(activity ?? (r.prompt ? `→ ${r.prompt}` : ""), promptBudget);
+      } else {
+        label = truncate(r.prompt ? `→ ${r.prompt}` : "", promptBudget);
+      }
       return {
         pid: String(r.pid),
         cli: r.cli,
@@ -419,17 +433,24 @@ async function cmdLs(rest: string[]): Promise<number> {
     const stopped = rows.find((r) => !r._alive);
     const hints: string[] = ["\n"];
     if (alive) {
-      hints.push(`  cy tail ${alive.pid}                  # view latest output\n`);
-      hints.push(`  cy tail -f ${alive.pid}               # follow live output\n`);
-      hints.push(`  cy send ${alive.pid} "next: ..."      # send a prompt\n`);
-      hints.push(`  cy send ${alive.pid} "" --code=ctrl-c # interrupt\n`);
-      hints.push(`  cy note ${alive.pid} "what it's doing" # set a note\n`);
+      hints.push(`  ay status ${alive.pid}                # JSON status snapshot\n`);
+      hints.push(`  ay status ${alive.pid} --watch        # stream changes as JSON\n`);
+      hints.push(`  ay tail ${alive.pid}                  # view latest output\n`);
+      hints.push(`  ay tail -f ${alive.pid}               # follow live output\n`);
+      hints.push(
+        `  ay send ${alive.pid} "next: ..."      # send a prompt (keyword: pid, cwd, or prompt substring)\n`,
+      );
+      hints.push(`  ay send ${alive.pid} "" --code=ctrl-c # interrupt\n`);
+      hints.push(`  ay note ${alive.pid} "what it's doing" # set a note\n`);
+      hints.push(
+        `  ay ls --json                           # machine-readable list for scripts/agents\n`,
+      );
     }
     if (stopped) {
-      hints.push(`  cy restart ${stopped.pid}             # restart stopped agent\n`);
+      hints.push(`  ay restart ${stopped.pid}             # restart stopped agent\n`);
     }
     if (!alive && !stopped)
-      hints.push(`  cy ls --all                          # show exited agents\n`);
+      hints.push(`  ay ls --all                          # show exited agents\n`);
     process.stderr.write(hints.join(""));
   }
 
@@ -459,7 +480,7 @@ function truncate(s: string, n: number): string {
 }
 
 // ---------------------------------------------------------------------------
-// cy read / cat / tail / head
+// ay read / cat / tail / head
 // ---------------------------------------------------------------------------
 
 interface ReadOpts {
@@ -534,10 +555,10 @@ async function cmdRead(rest: string[], { mode }: ReadOpts): Promise<number> {
 
   process.stderr.write(
     `\n` +
-      `  cy ls                                 # list all agents\n` +
-      `  cy tail -f ${record.pid}              # follow live output\n` +
-      `  cy send ${record.pid} "next: ..."      # send a prompt\n` +
-      `  cy send ${record.pid} "" --code=ctrl-c # interrupt\n`,
+      `  ay ls                                 # list all agents\n` +
+      `  ay tail -f ${record.pid}              # follow live output\n` +
+      `  ay send ${record.pid} "next: ..."      # send a prompt\n` +
+      `  ay send ${record.pid} "" --code=ctrl-c # interrupt\n`,
   );
   return 0;
 }
@@ -589,7 +610,125 @@ async function renderRawLog(
 }
 
 // ---------------------------------------------------------------------------
-// cy send
+// activity extraction
+// ---------------------------------------------------------------------------
+
+/**
+ * Extract a one-line activity summary from a raw log file.
+ * Reads only the last 32 KB for speed, renders via xterm for clean output.
+ */
+async function extractActivity(logPath: string): Promise<string | null> {
+  const TAIL_BYTES = 32 * 1024;
+  let buf: Uint8Array;
+  try {
+    const fh = await open(logPath, "r");
+    try {
+      const { size } = await fh.stat();
+      if (size === 0) return null;
+      if (size <= TAIL_BYTES) {
+        const data = await fh.readFile();
+        buf = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+      } else {
+        const tmp = Buffer.alloc(TAIL_BYTES);
+        const { bytesRead } = await fh.read(tmp, 0, TAIL_BYTES, size - TAIL_BYTES);
+        buf = new Uint8Array(tmp.buffer, 0, bytesRead);
+      }
+    } finally {
+      await fh.close();
+    }
+  } catch {
+    return null;
+  }
+
+  try {
+    const rendered = await renderRawLog(buf, { mode: "tail", n: 40 });
+    return extractActivityFromLines(rendered.split("\n"));
+  } catch {
+    return null;
+  }
+}
+
+function extractActivityFromLines(lines: string[]): string | null {
+  // Claude Code UI chrome: these lines carry no meaningful activity info
+  const isChrome = (l: string): boolean => {
+    const s = l.trim();
+    return (
+      !s ||
+      /^─+$/.test(s) ||
+      s.startsWith("? for shortcuts") ||
+      /^esc to interrupt/i.test(s) ||
+      /\d+%\s*until auto-compact/i.test(s) ||
+      /^\/model\s+/i.test(s) ||
+      /^⧉\s+In\s+/i.test(s) ||
+      /^●\s+(high|medium|low)\s*[·•]/i.test(s) ||
+      /^[·•]\s*\d+\s+(left|request)/i.test(s)
+    );
+  };
+
+  const clean = lines.filter((l) => !isChrome(l));
+
+  const isSpinnerLine = (l: string) =>
+    /^[^\w\s❯>⎿✓✗]\s+[A-Z]\w+[….]/u.test(l.trim()) || /still thinking/i.test(l);
+
+  // Find positions of the last ❯ prompt and last spinner in the rendered output.
+  // If ❯ comes after the last spinner, the agent finished and is waiting — show
+  // idle state rather than the stale spinner description.
+  let lastPromptIdx = -1;
+  let lastSpinnerIdx = -1;
+  for (let i = clean.length - 1; i >= 0; i--) {
+    const l = clean[i]!.trim();
+    if (lastPromptIdx === -1 && l.startsWith("❯")) lastPromptIdx = i;
+    if (lastSpinnerIdx === -1 && isSpinnerLine(l)) lastSpinnerIdx = i;
+    if (lastPromptIdx !== -1 && lastSpinnerIdx !== -1) break;
+  }
+
+  // ❯ appears after (or without) any spinner → agent is idle/waiting for input
+  if (lastPromptIdx > lastSpinnerIdx) {
+    const text = clean[lastPromptIdx]!.trim()
+      .replace(/^❯\s*/, "")
+      .trim();
+    return text ? `» ${text}` : null;
+  }
+
+  // Priority 1: thinking/composing spinner active
+  // Claude Code cycles through various Unicode dingbats for its spinner (✢✳✶✻✷…).
+  // The format is always: SPINNER_CHAR Verb… (timing…)
+  // Require ellipsis after the verb so we don't false-positive on normal text
+  // that happens to contain one of these chars mid-sentence.
+  const thinkingLine = clean.find((l) => isSpinnerLine(l));
+  if (thinkingLine) {
+    const m = /^.\s+(\w+[^(]*)(?:\s*\(|$)/u.exec(thinkingLine.trim());
+    return m?.[1] ? `✳ ${m[1].trim()}` : "thinking…";
+  }
+
+  // Priority 3: ✻ spinner just finished — show nearby context
+  const cookIdx = clean.findIndex((l) => /^✻\s+/.test(l.trim()));
+  if (cookIdx >= 0) {
+    const window = clean.slice(Math.max(0, cookIdx - 8), cookIdx);
+    for (let i = window.length - 1; i >= 0; i--) {
+      const l = window[i]!.trim();
+      if (l && !/^[✻✢⧉❯]/.test(l) && !isChrome(l)) {
+        return l.length > 80 ? l.slice(0, 79) + "…" : l;
+      }
+    }
+  }
+
+  // Priority 4: last meaningful non-icon line
+  for (let i = clean.length - 1; i >= 0; i--) {
+    const l = clean[i]!.trim();
+    // Skip lines that look like spinner patterns (caught by priority 1 above)
+    // and status dots/separators; everything else (including ⎿ tool sub-output
+    // and non-ASCII text like Japanese) is fair game as meaningful content.
+    if (l && !/^[─●○◉⧉]/.test(l) && !/^[^\w\s❯>]\s+[A-Z]\w+[….]/u.test(l)) {
+      return l.length > 80 ? l.slice(0, 79) + "…" : l;
+    }
+  }
+
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// ay send
 // ---------------------------------------------------------------------------
 
 async function cmdSend(rest: string[]): Promise<number> {
@@ -599,7 +738,7 @@ async function cmdSend(rest: string[]): Promise<number> {
   const rawMessage = positional.slice(1).join(" ");
 
   if (!keyword)
-    throw new Error("usage: cy send <keyword> <msg|-> [--code=enter|esc|ctrl-c|ctrl-y|tab|none]");
+    throw new Error("usage: ay send <keyword> <msg|-> [--code=enter|esc|ctrl-c|ctrl-y|tab|none]");
 
   const codeName = typeof flags.code === "string" ? flags.code.toLowerCase() : "enter";
   const trailing = controlCodeFromName(codeName);
@@ -621,20 +760,30 @@ async function cmdSend(rest: string[]): Promise<number> {
     body = rawMessage;
   }
 
-  if (body && trailing) {
-    await writeToIpc(fifoPath, body);
+  const sourcePid = process.env.AGENT_YES_PID ? Number(process.env.AGENT_YES_PID) : null;
+  const talkBack = sourcePid
+    ? `\n(from AGENT_YES_PID=${sourcePid} — reply: ay send ${sourcePid} "...")`
+    : "";
+
+  const fullBody = body + talkBack;
+  if (fullBody && trailing) {
+    await writeToIpc(fifoPath, fullBody);
     await new Promise((r) => setTimeout(r, 200));
     await writeToIpc(fifoPath, trailing);
   } else {
-    await writeToIpc(fifoPath, body + trailing);
+    await writeToIpc(fifoPath, fullBody + trailing);
   }
   const payload = body + trailing;
   process.stdout.write(`sent to pid ${record.pid} (${record.cli}): ${truncate(payload, 80)}\n`);
 
+  const replyHint = sourcePid
+    ? `  ay send ${sourcePid} "..."              # reply to sender\n`
+    : "";
   process.stderr.write(
     `\n` +
-      `  cy tail ${record.pid}                  # watch output\n` +
-      `  cy ls                                  # list all agents\n`,
+      replyHint +
+      `  ay tail ${record.pid}                  # watch output\n` +
+      `  ay ls                                  # list all agents\n`,
   );
   return 0;
 }
@@ -702,7 +851,7 @@ async function writeToIpc(ipcPath: string, payload: string): Promise<void> {
 }
 
 // ---------------------------------------------------------------------------
-// cy restart
+// ay restart
 // ---------------------------------------------------------------------------
 
 async function cmdRestart(rest: string[]): Promise<number> {
@@ -712,7 +861,7 @@ async function cmdRestart(rest: string[]): Promise<number> {
   const record = await resolveOne(keyword, opts);
 
   if (isPidAlive(record.pid)) {
-    process.stderr.write(`pid ${record.pid} is still running — stop it first or use cy send\n`);
+    process.stderr.write(`pid ${record.pid} is still running — stop it first or use ay send\n`);
     return 1;
   }
 
@@ -730,14 +879,14 @@ async function cmdRestart(rest: string[]): Promise<number> {
   );
   process.stderr.write(
     `\n` +
-      `  cy tail ${proc.pid}   # watch output\n` +
-      `  cy ls                 # list all agents\n`,
+      `  ay tail ${proc.pid}   # watch output\n` +
+      `  ay ls                 # list all agents\n`,
   );
   return 0;
 }
 
 // ---------------------------------------------------------------------------
-// cy note
+// ay note
 // ---------------------------------------------------------------------------
 
 async function cmdNote(rest: string[]): Promise<number> {
@@ -746,7 +895,7 @@ async function cmdNote(rest: string[]): Promise<number> {
   const keyword = positional[0];
   const note = positional.slice(1).join(" ");
 
-  if (!keyword) throw new Error('usage: cy note <keyword> ["note text"]  (omit text to clear)');
+  if (!keyword) throw new Error('usage: ay note <keyword> ["note text"]  (omit text to clear)');
 
   const record = await resolveOne(keyword, { ...opts, all: true });
 
@@ -760,6 +909,114 @@ async function cmdNote(rest: string[]): Promise<number> {
 
   await writeNote(record.pid, note);
   process.stdout.write(`note set for pid ${record.pid}: ${note}\n`);
-  process.stderr.write(`\n  cy ls   # see updated note in list\n`);
+  process.stderr.write(`\n  ay ls   # see updated note in list\n`);
+  return 0;
+}
+
+// ---------------------------------------------------------------------------
+// ay status
+// ---------------------------------------------------------------------------
+
+interface StatusSnapshot {
+  pid: number;
+  cli: string;
+  cwd: string;
+  state: "active" | "idle" | "stopped";
+  activity: string | null;
+  note: string | null;
+  log_mtime_ms: number | null;
+  started_at: number;
+  age_ms: number;
+  exit_code: number | null;
+  exit_reason: string | null;
+  log_file: string | null;
+}
+
+async function snapshotStatus(record: GlobalPidRecord): Promise<StatusSnapshot> {
+  const alive = isPidAlive(record.pid);
+  let state: "active" | "idle" | "stopped";
+  let logMtimeMs: number | null = null;
+  if (!alive) {
+    state = "stopped";
+  } else if (record.log_file) {
+    logMtimeMs = await stat(record.log_file)
+      .then((s) => s.mtimeMs)
+      .catch(() => null);
+    state = logMtimeMs !== null && Date.now() - logMtimeMs > IDLE_THRESHOLD_MS ? "idle" : "active";
+  } else {
+    state = "active";
+  }
+  const activity =
+    state !== "stopped" && record.log_file ? await extractActivity(record.log_file) : null;
+  const notes = await readNotes();
+  const note = notes.get(record.pid) ?? null;
+  return {
+    pid: record.pid,
+    cli: record.cli,
+    cwd: record.cwd,
+    state,
+    activity,
+    note,
+    log_mtime_ms: logMtimeMs,
+    started_at: record.started_at,
+    age_ms: Date.now() - record.started_at,
+    exit_code: record.exit_code,
+    exit_reason: record.exit_reason,
+    log_file: record.log_file ?? null,
+  };
+}
+
+async function cmdStatus(rest: string[]): Promise<number> {
+  const { flags, positional } = parseArgs(rest);
+  const opts = { ...commonOpts(flags), all: true };
+  const keyword = positional[0];
+
+  if (!keyword) throw new Error("usage: ay status <keyword> [--watch] [--interval=N]");
+
+  const watch = !!(flags.watch || flags.w);
+  const intervalFlag = typeof flags.interval === "string" ? Number(flags.interval) : 2;
+  const intervalMs = Math.max(500, (Number.isFinite(intervalFlag) ? intervalFlag : 2) * 1000);
+
+  const record = await resolveOne(keyword, opts);
+
+  const emit = (snap: StatusSnapshot, ts?: number): void => {
+    const out = ts !== undefined ? { ts, ...snap } : snap;
+    process.stdout.write(JSON.stringify(out) + "\n");
+  };
+
+  if (!watch) {
+    emit(await snapshotStatus(record));
+    return 0;
+  }
+
+  process.stderr.write(
+    `watching pid ${record.pid} every ${intervalMs / 1000}s… (Ctrl-C to stop)\n`,
+  );
+
+  let prev: { state: string; activity: string | null; exit_code: number | null } | null = null;
+
+  const tick = async (): Promise<void> => {
+    const snap = await snapshotStatus(record);
+    if (
+      prev === null ||
+      snap.state !== prev.state ||
+      snap.activity !== prev.activity ||
+      snap.exit_code !== prev.exit_code
+    ) {
+      emit(snap, Date.now());
+      prev = { state: snap.state, activity: snap.activity, exit_code: snap.exit_code };
+    }
+  };
+
+  await tick();
+
+  await new Promise<void>((resolve) => {
+    const timer = setInterval(tick, intervalMs);
+    process.on("SIGINT", () => {
+      clearInterval(timer);
+      resolve();
+    });
+  });
+
   return 0;
 }