claude-yes 1.81.0 → 1.83.0

package/dist/{SUPPORTED_CLIS-DuXIXbBo.js → SUPPORTED_CLIS-DkXclUge.js}

@@ -1,6 +1,6 @@
-import { t as CLIS_CONFIG } from "./ts-DUtCG3W_.js";
+import { t as CLIS_CONFIG } from "./ts-DbdWuoGq.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-CK3Inq3r.js";
+import "./versionChecker-Ct-4UPeG.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-DuXIXbBo.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-DkXclUge.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-CK3Inq3r.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-Ct-4UPeG.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -475,7 +475,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 	}
 }
 {
-	const { isSubcommand, runSubcommand } = await import("./subcommands-BT4I9SM0.js");
+	const { isSubcommand, runSubcommand } = await import("./subcommands-Vt_yQiEZ.js");
 	if (isSubcommand(process.argv[2])) {
 		const code = await runSubcommand(process.argv);
 		process.exit(code ?? 0);
@@ -504,7 +504,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-DuXIXbBo.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-DkXclUge.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-DUtCG3W_.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-DbdWuoGq.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-CK3Inq3r.js";
+import "./versionChecker-Ct-4UPeG.js";
 import "./pidStore-C1JXxoPi.js";
 import "./globalPidIndex-Cr-g75QF.js";
 

package/dist/{subcommands-BT4I9SM0.js → subcommands-Vt_yQiEZ.js}

@@ -1,6 +1,6 @@
 import "./logger-B9h0djqx.js";
 import { r as readGlobalPids } from "./globalPidIndex-Cr-g75QF.js";
-import { readFile, stat } from "fs/promises";
+import { appendFile, mkdir, open, readFile, stat, writeFile } from "fs/promises";
 import { homedir } from "os";
 import path from "path";
 
@@ -17,6 +17,47 @@ import path from "path";
 * Returns null when argv[2] is not a known subcommand so cli.ts falls through
 * to the normal agent-spawning flow.
 */
+function notesPath() {
+	const dir = process.env.AGENT_YES_HOME ?? path.join(homedir(), ".agent-yes");
+	return path.join(dir, "notes.jsonl");
+}
+async function readNotes() {
+	let raw;
+	try {
+		raw = await readFile(notesPath(), "utf-8");
+	} catch {
+		return /* @__PURE__ */ new Map();
+	}
+	const map = /* @__PURE__ */ new Map();
+	for (const line of raw.split("\n")) {
+		const t = line.trim();
+		if (!t) continue;
+		try {
+			const { pid, note } = JSON.parse(t);
+			if (typeof pid === "number") if (note) map.set(pid, note);
+			else map.delete(pid);
+		} catch {}
+	}
+	return map;
+}
+async function writeNote(pid, note) {
+	const p = notesPath();
+	await mkdir(path.dirname(p), { recursive: true });
+	await appendFile(p, JSON.stringify({
+		pid,
+		note,
+		updated_at: Date.now()
+	}) + "\n");
+}
+async function compactNotes() {
+	const map = await readNotes();
+	const lines = Array.from(map.entries()).map(([pid, note]) => JSON.stringify({
+		pid,
+		note,
+		updated_at: Date.now()
+	})).join("\n");
+	await writeFile(notesPath(), lines ? lines + "\n" : "");
+}
 /**
 * 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
@@ -82,7 +123,8 @@ const SUBCOMMANDS = new Set([
 	"tail",
 	"head",
 	"send",
-	"restart"
+	"restart",
+	"note"
 ]);
 function isSubcommand(name) {
 	return !!name && SUBCOMMANDS.has(name);
@@ -106,6 +148,7 @@ async function runSubcommand(argv) {
 			case "head": return await cmdRead(rest, { mode: "head" });
 			case "send": return await cmdSend(rest);
 			case "restart": return await cmdRestart(rest);
+			case "note": return await cmdNote(rest);
 			default: return null;
 		}
 	} catch (err) {
@@ -220,6 +263,7 @@ 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;
 		if (!isPidAlive(r.pid)) displayStatus = "stopped";
@@ -227,13 +271,22 @@ 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 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 ?? "", promptBudget);
+		else label = truncate(r.prompt ?? "", promptBudget);
 		return {
 			pid: String(r.pid),
 			cli: r.cli,
 			status: displayStatus,
 			age: humanizeAge(Date.now() - r.started_at),
 			cwd: shortenPath(r.cwd),
-			prompt: truncate(r.prompt ?? "", promptBudget),
+			label,
+			hasNote,
 			_alive: displayStatus !== "stopped"
 		};
 	}));
@@ -243,7 +296,7 @@ async function cmdLs(rest) {
 		"STATUS".padEnd(widths.status),
 		"AGE".padEnd(widths.age),
 		"CWD".padEnd(widths.cwd),
-		"PROMPT"
+		"NOTE/PROMPT"
 	].join("  ") + "\n";
 	process.stdout.write(header);
 	for (const r of rows) process.stdout.write([
@@ -252,7 +305,7 @@ async function cmdLs(rest) {
 		r.status.padEnd(widths.status),
 		r.age.padEnd(widths.age),
 		r.cwd.padEnd(widths.cwd),
-		r.prompt
+		r.hasNote ? `* ${r.label}` : r.label
 	].join("  ") + "\n");
 	if (!opts.json && rows.length > 0) {
 		const alive = rows.find((r) => r._alive);
@@ -263,6 +316,7 @@ async function cmdLs(rest) {
 			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`);
 		}
 		if (stopped) hints.push(`  cy restart ${stopped.pid}             # restart stopped agent\n`);
 		if (!alive && !stopped) hints.push(`  cy ls --all                          # show exited agents\n`);
@@ -310,7 +364,9 @@ async function cmdRead(rest, { mode }) {
 		mode,
 		n
 	});
-	process.stderr.write(`[pid ${record.pid}  ${shortenPath(record.cwd)}]\n`);
+	const noteLabel = (await readNotes()).get(record.pid);
+	const header = noteLabel ? `[pid ${record.pid}  ${shortenPath(record.cwd)}  * ${noteLabel}]` : `[pid ${record.pid}  ${shortenPath(record.cwd)}]`;
+	process.stderr.write(header + "\n");
 	process.stdout.write(rendered);
 	if (!rendered.endsWith("\n")) process.stdout.write("\n");
 	if (follow) {
@@ -376,6 +432,71 @@ 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 thinkingLine = clean.find((l) => /^[^\w\s❯>⎿✓✗]\s+[A-Z]\w+[….]/u.test(l.trim()) || /still thinking/i.test(l));
+	if (thinkingLine) {
+		const m = /^.\s+(\w+[^(]*)(?:\s*\(|$)/u.exec(thinkingLine.trim());
+		return m ? `✳ ${m[1].trim()}` : "thinking…";
+	}
+	const promptLines = clean.filter((l) => /^❯\s+/.test(l.trim()));
+	if (promptLines.length > 0) {
+		const text = promptLines[promptLines.length - 1].trim().replace(/^❯\s+/, "").trim();
+		if (text) return `» ${text}`;
+	}
+	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);
@@ -481,7 +602,28 @@ async function cmdRestart(rest) {
 	process.stderr.write(`\n  cy tail ${proc.pid}   # watch output\n  cy ls                 # list all agents\n`);
 	return 0;
 }
+async function cmdNote(rest) {
+	const { flags, positional } = parseArgs(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)");
+	const record = await resolveOne(keyword, {
+		...opts,
+		all: true
+	});
+	if (!note) {
+		await writeNote(record.pid, "");
+		await compactNotes();
+		process.stdout.write(`cleared note for pid ${record.pid}\n`);
+		return 0;
+	}
+	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`);
+	return 0;
+}
 
 //#endregion
 export { isSubcommand, runSubcommand };
-//# sourceMappingURL=subcommands-BT4I9SM0.js.map
+//# sourceMappingURL=subcommands-Vt_yQiEZ.js.map

package/dist/{ts-DUtCG3W_.js → ts-DbdWuoGq.js}

@@ -1,5 +1,5 @@
 import { n as logger, t as addTransport } from "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-CK3Inq3r.js";
+import { r as getInstalledPackage } from "./versionChecker-Ct-4UPeG.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-C22d9SRJ.js";
 import { t as PidStore } from "./pidStore-C1JXxoPi.js";
 import { arch, platform } from "process";
@@ -1679,4 +1679,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-DUtCG3W_.js.map
+//# sourceMappingURL=ts-DbdWuoGq.js.map

package/dist/{versionChecker-CK3Inq3r.js → versionChecker-Ct-4UPeG.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "claude-yes";
-var version = "1.81.0";
+var version = "1.83.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-CK3Inq3r.js.map
+//# sourceMappingURL=versionChecker-Ct-4UPeG.js.map

package/package.json

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

package/ts/subcommands.spec.ts

@@ -307,7 +307,7 @@ describe("subcommands.cmdLs human table", () => {
     } finally {
       cap.restore();
     }
-    expect(cap.text).toMatch(/PID\s+CLI\s+STATUS\s+AGE\s+CWD\s+PROMPT/);
+    expect(cap.text).toMatch(/PID\s+CLI\s+STATUS\s+AGE\s+CWD\s+NOTE\/PROMPT/);
     expect(cap.text).toMatch(new RegExp(`${process.pid}\\s`));
     expect(cap.text).toMatch(/claude/);
     expect(cap.text).toMatch(/table format test/);

package/ts/subcommands.ts

@@ -11,11 +11,58 @@
  * to the normal agent-spawning flow.
  */
 
-import { readFile, stat } 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";
 
+// ---------------------------------------------------------------------------
+// notes store  (~/.agent-yes/notes.jsonl)
+// ---------------------------------------------------------------------------
+
+function notesPath(): string {
+  const dir = process.env.AGENT_YES_HOME ?? path.join(homedir(), ".agent-yes");
+  return path.join(dir, "notes.jsonl");
+}
+
+async function readNotes(): Promise<Map<number, string>> {
+  let raw: string;
+  try {
+    raw = await readFile(notesPath(), "utf-8");
+  } catch {
+    return new Map();
+  }
+  const map = new Map<number, string>();
+  for (const line of raw.split("\n")) {
+    const t = line.trim();
+    if (!t) continue;
+    try {
+      const { pid, note } = JSON.parse(t);
+      if (typeof pid === "number") {
+        if (note) map.set(pid, note);
+        else map.delete(pid);
+      }
+    } catch {
+      /* skip */
+    }
+  }
+  return map;
+}
+
+async function writeNote(pid: number, note: string): Promise<void> {
+  const p = notesPath();
+  await mkdir(path.dirname(p), { recursive: true });
+  await appendFile(p, JSON.stringify({ pid, note, updated_at: Date.now() }) + "\n");
+}
+
+async function compactNotes(): Promise<void> {
+  const map = await readNotes();
+  const lines = Array.from(map.entries())
+    .map(([pid, note]) => JSON.stringify({ pid, note, updated_at: Date.now() }))
+    .join("\n");
+  await writeFile(notesPath(), lines ? lines + "\n" : "");
+}
+
 /**
  * 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
@@ -76,7 +123,18 @@ function mergeRecords(...buckets: GlobalPidRecord[][]): GlobalPidRecord[] {
   return Array.from(out.values());
 }
 
-const SUBCOMMANDS = new Set(["ls", "list", "ps", "read", "cat", "tail", "head", "send", "restart"]);
+const SUBCOMMANDS = new Set([
+  "ls",
+  "list",
+  "ps",
+  "read",
+  "cat",
+  "tail",
+  "head",
+  "send",
+  "restart",
+  "note",
+]);
 
 export function isSubcommand(name: string | undefined): boolean {
   return !!name && SUBCOMMANDS.has(name);
@@ -109,6 +167,8 @@ export async function runSubcommand(argv: string[]): Promise<number | null> {
         return await cmdSend(rest);
       case "restart":
         return await cmdRestart(rest);
+      case "note":
+        return await cmdNote(rest);
       default:
         return null;
     }
@@ -300,6 +360,7 @@ async function cmdLs(rest: string[]): Promise<number> {
   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) => {
       let displayStatus: string;
@@ -314,13 +375,26 @@ async function cmdLs(rest: string[]): Promise<number> {
       } else {
         displayStatus = "active";
       }
+      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 ?? "", promptBudget);
+      } else {
+        label = truncate(r.prompt ?? "", promptBudget);
+      }
       return {
         pid: String(r.pid),
         cli: r.cli,
         status: displayStatus,
         age: humanizeAge(Date.now() - r.started_at),
         cwd: shortenPath(r.cwd),
-        prompt: truncate(r.prompt ?? "", promptBudget),
+        label,
+        hasNote,
         _alive: displayStatus !== "stopped",
       };
     }),
@@ -333,7 +407,7 @@ async function cmdLs(rest: string[]): Promise<number> {
       "STATUS".padEnd(widths.status),
       "AGE".padEnd(widths.age),
       "CWD".padEnd(widths.cwd),
-      "PROMPT",
+      "NOTE/PROMPT",
     ].join("  ") + "\n";
   process.stdout.write(header);
 
@@ -345,7 +419,7 @@ async function cmdLs(rest: string[]): Promise<number> {
         r.status.padEnd(widths.status),
         r.age.padEnd(widths.age),
         r.cwd.padEnd(widths.cwd),
-        r.prompt,
+        r.hasNote ? `* ${r.label}` : r.label,
       ].join("  ") + "\n",
     );
   }
@@ -359,6 +433,7 @@ async function cmdLs(rest: string[]): Promise<number> {
       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`);
     }
     if (stopped) {
       hints.push(`  cy restart ${stopped.pid}             # restart stopped agent\n`);
@@ -433,7 +508,12 @@ async function cmdRead(rest: string[], { mode }: ReadOpts): Promise<number> {
 
   const buf = await readFile(logPath);
   const rendered = await renderRawLog(buf, { mode, n });
-  process.stderr.write(`[pid ${record.pid}  ${shortenPath(record.cwd)}]\n`);
+  const notes = await readNotes();
+  const noteLabel = notes.get(record.pid);
+  const header = noteLabel
+    ? `[pid ${record.pid}  ${shortenPath(record.cwd)}  * ${noteLabel}]`
+    : `[pid ${record.pid}  ${shortenPath(record.cwd)}]`;
+  process.stderr.write(header + "\n");
   process.stdout.write(rendered);
   if (!rendered.endsWith("\n")) process.stdout.write("\n");
 
@@ -518,6 +598,112 @@ async function renderRawLog(
   }
 }
 
+// ---------------------------------------------------------------------------
+// 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));
+
+  // 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) => /^[^\w\s❯>⎿✓✗]\s+[A-Z]\w+[….]/u.test(l.trim()) || /still thinking/i.test(l),
+  );
+  if (thinkingLine) {
+    const m = /^.\s+(\w+[^(]*)(?:\s*\(|$)/u.exec(thinkingLine.trim());
+    return m ? `✳ ${m[1].trim()}` : "thinking…";
+  }
+
+  // Priority 2: last ❯ prompt line means agent is idle, waiting for next input
+  const promptLines = clean.filter((l) => /^❯\s+/.test(l.trim()));
+  if (promptLines.length > 0) {
+    const text = promptLines[promptLines.length - 1]!.trim()
+      .replace(/^❯\s+/, "")
+      .trim();
+    if (text) return `» ${text}`;
+  }
+
+  // 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;
+}
+
 // ---------------------------------------------------------------------------
 // cy send
 // ---------------------------------------------------------------------------
@@ -665,3 +851,31 @@ async function cmdRestart(rest: string[]): Promise<number> {
   );
   return 0;
 }
+
+// ---------------------------------------------------------------------------
+// cy note
+// ---------------------------------------------------------------------------
+
+async function cmdNote(rest: string[]): Promise<number> {
+  const { flags, positional } = parseArgs(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)');
+
+  const record = await resolveOne(keyword, { ...opts, all: true });
+
+  if (!note) {
+    // clear
+    await writeNote(record.pid, "");
+    await compactNotes();
+    process.stdout.write(`cleared note for pid ${record.pid}\n`);
+    return 0;
+  }
+
+  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`);
+  return 0;
+}