@nuniapp/cli 0.1.8 → 0.1.10

package/README.md

@@ -14,9 +14,11 @@ Read, reply to and resolve comments from the terminal, or let your coding agent
 ```sh
 npx @nuniapp/cli@latest login              # approve this terminal in the Nuni dashboard
 npx @nuniapp/cli@latest comments           # open comments, newest first
+npx @nuniapp/cli@latest comments --search "typo" --group element
+npx @nuniapp/cli@latest pages              # pages with open comments
 npx @nuniapp/cli@latest comment <id>       # one comment with the element, DOM, console and screenshot
 npx @nuniapp/cli@latest reply <id> "message"
-npx @nuniapp/cli@latest resolve <id> --note "what changed"
+npx @nuniapp/cli@latest resolve <id...> --note "what changed"
 claude mcp add nuni -- npx -y @nuniapp/cli@latest mcp
 ```
 

package/dist/index.mjs

@@ -6,7 +6,7 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync,
 import { homedir } from "node:os";
 import { createInterface } from "node:readline";
 //#region package.json
-var version$1 = "0.1.8";
+var version$1 = "0.1.10";
 //#endregion
 //#region ../shared/src/path.ts
 /** URL that opens the page with the comment focused by the widget. */
@@ -80,7 +80,16 @@ function buildCommentPrompt(comment, options = {}) {
 	const includeContext = options.includeContext ?? true;
 	const { anchor, page } = comment;
 	const out = [];
-	out.push("Fix this piece of feedback that was left on the live site with Nuni.", "", "## Comment", "", quote(comment.body), "", `From ${comment.authorName} on ${new Date(comment.createdAt).toISOString().slice(0, 10)}` + (comment.status === "resolved" ? " (already resolved)" : ""));
+	out.push("Fix this piece of feedback that was left on the live site with Nuni.", "", "## Comment", "", ...comment.body ? [quote(comment.body), ""] : [], ...comment.suggestion ? [
+		"Suggested text change. Replace:",
+		"",
+		quote(comment.suggestion.before),
+		"",
+		"With:",
+		"",
+		quote(comment.suggestion.after),
+		""
+	] : [], `From ${comment.authorName} on ${new Date(comment.createdAt).toISOString().slice(0, 10)}` + (comment.status === "resolved" ? comment.resolution === "outdated" ? " (closed as outdated)" : " (already resolved)" : ""));
 	if (comment.replies?.length) {
 		out.push("", `## Replies (${comment.replies.length})`, "");
 		for (const reply of comment.replies) out.push(`${reply.authorName}${reply.isOwner ? " (owner)" : ""}:`, quote(reply.body), "");
@@ -92,6 +101,7 @@ function buildCommentPrompt(comment, options = {}) {
 	out.push(`- Viewport: ${comment.viewport.w}×${comment.viewport.h} at ${comment.viewport.dpr}x`);
 	if (includeContext && comment.userAgent) out.push(`- Browser: ${comment.userAgent}`);
 	out.push("", "## Element", "");
+	if (comment.pinLostAt) out.push(`- Not found on the page since ${new Date(comment.pinLostAt).toISOString().slice(0, 10)}: it may have changed or been removed. Check whether the feedback still applies.`);
 	out.push(`- Tag: <${anchor.tag}>`);
 	if (anchor.text) out.push(`- Text: ${inline(anchor.text)}`);
 	if (anchor.quote) out.push(`- Selected text: ${inline(anchor.quote.exact)}`);
@@ -119,8 +129,9 @@ function buildCommentPrompt(comment, options = {}) {
 		out.push("", `## Failed requests (${context.network.length})`, "");
 		for (const r of context.network) out.push(`- ${r.method} ${r.url} → ${r.status === 0 ? "network error" : r.status}`);
 	}
+	if (comment.imageUrls?.length) out.push("", `## Images from ${comment.authorName} (${comment.imageUrls.length})`, "", ...comment.imageUrls.map((url) => `- ${url}`));
 	if (includeContext && comment.screenshotUrl) out.push("", "## Screenshot", "", comment.screenshotUrl);
-	out.push("", "## Steps", "", "1. Find the code that renders this element. Search for the text, the component name, the test ID or the selector.", "2. Make the change the comment asks for, and keep the fix focused on it.", "3. Tell me what you changed, so the comment can be resolved in Nuni.", `   If the Nuni CLI is signed in to this project (\`npx ${PACKAGES.cli}@latest login\`), resolve it with \`npx ${PACKAGES.cli}@latest resolve ${comment._id}\` or the \`resolve_comment\` MCP tool.`);
+	out.push("", "## Steps", "", "1. Find the code that renders this element. Search for the text, the component name, the test ID or the selector.", comment.suggestion ? "2. Replace the text exactly as suggested (wherever it comes from: markup, a component, a translation or content file), and keep the fix focused on it." : "2. Make the change the comment asks for, and keep the fix focused on it.", "3. Tell me what you changed, so the comment can be resolved in Nuni.", `   If the Nuni CLI is signed in to this project (\`npx ${PACKAGES.cli}@latest login\`), resolve it with \`npx ${PACKAGES.cli}@latest resolve ${comment._id}\` or the \`resolve_comment\` MCP tool.`);
 	return out.join("\n");
 }
 //#endregion
@@ -237,17 +248,62 @@ function oneLine(text, max = 120) {
 	const clean = text.replace(/\s+/g, " ").trim();
 	return clean.length > max ? `${clean.slice(0, max - 1)}…` : clean;
 }
-/** A compact, numbered list: enough to pick a comment, not the full context. */
+/**
+* What a comment is about, for grouping: the page plus the element's
+* strongest selector, plus the words for a text comment.
+*/
+function elementKey(c) {
+	const { selectors } = c.anchor;
+	const target = selectors.testId ? `[data-testid="${selectors.testId}"]` : selectors.id ? `#${selectors.id}` : selectors.css ?? selectors.path;
+	const quote = c.anchor.quote ? ` "${oneLine(c.anchor.quote.exact, 60)}"` : "";
+	return `${c.page.path} · ${target}${quote}`;
+}
+function describe(c, n) {
+	const element = c.anchor.text ? `<${c.anchor.tag}> "${oneLine(c.anchor.text, 60)}"` : `<${c.anchor.tag}>`;
+	return [
+		`${n}. ${c._id} · ${c.page.path} · ${c.authorName} · ${timeAgo(c.createdAt)}${c.pinLost ? " · element not found" : ""}`,
+		...c.body ? [`   "${oneLine(c.body)}"`] : [],
+		...c.suggestion ? [`   Suggests: "${oneLine(c.suggestion.before, 60)}" → "${oneLine(c.suggestion.after, 60)}"`] : [],
+		c.anchor.quote ? `   On the text "${oneLine(c.anchor.quote.exact, 60)}" in ${element}` : `   ${c.anchor.region ? "On an area of" : "On"} ${element}`
+	];
+}
+/**
+* A compact, numbered list: enough to pick a comment, not the full context.
+* Grouped by page or by element, related comments sit together so they can
+* be fixed in one go.
+*/
 function formatCommentList(comments, options) {
 	if (!comments.length) return `No ${options.status} comments.`;
-	const lines = [`${comments.length}${options.more ? "+" : ""} ${options.status} comment${comments.length === 1 ? "" : "s"}, newest first:`, ""];
-	comments.forEach((c, i) => {
-		const element = c.anchor.text ? `<${c.anchor.tag}> "${oneLine(c.anchor.text, 60)}"` : `<${c.anchor.tag}>`;
-		lines.push(`${i + 1}. ${c._id} · ${c.page.path} · ${c.authorName} · ${timeAgo(c.createdAt)}`, `   "${oneLine(c.body)}"`, c.anchor.quote ? `   On the text "${oneLine(c.anchor.quote.exact, 60)}" in ${element}` : `   ${c.anchor.region ? "On an area of" : "On"} ${element}`);
-	});
+	const lines = [`${comments.length}${options.more ? "+" : ""} ${options.status} comment${comments.length === 1 ? "" : "s"}, ${options.order ?? "newest first"}${options.groupBy ? `, grouped by ${options.groupBy}` : ""}:`, ""];
+	if (!options.groupBy) comments.forEach((c, i) => lines.push(...describe(c, i + 1)));
+	else {
+		const keyOf = options.groupBy === "page" ? (c) => c.page.path : elementKey;
+		const groups = /* @__PURE__ */ new Map();
+		for (const c of comments) {
+			const key = keyOf(c);
+			groups.set(key, [...groups.get(key) ?? [], c]);
+		}
+		let n = 0;
+		for (const [key, group] of groups) {
+			lines.push(`## ${key} (${group.length})`);
+			for (const c of group) lines.push(...describe(c, ++n));
+			lines.push("");
+		}
+		lines.pop();
+	}
 	lines.push("", options.detailHint);
 	return lines.join("\n");
 }
+/** Pages with open comments, most first. */
+function formatPageList(pages) {
+	if (!pages.length) return "No pages with open comments.";
+	const width = Math.max(...pages.map((p) => String(p.openCount).length));
+	return [
+		`${pages.length} page${pages.length === 1 ? "" : "s"} with open comments:`,
+		"",
+		...pages.map((p) => `${String(p.openCount).padStart(width)} open  ${p.path}`)
+	].join("\n");
+}
 //#endregion
 //#region src/project.ts
 const SKIP_DIRS = /* @__PURE__ */ new Set([
@@ -1264,6 +1320,10 @@ function createRemote() {
 				...options
 			});
 		}),
+		listPages: (publicId, token) => call(() => client.query(api.comments.pagesForAgent, {
+			publicId,
+			sessionToken: token
+		})),
 		getComment: (publicId, token, id) => call(async () => {
 			return await client.query(api.comments.getForOwner, {
 				publicId,
@@ -1289,6 +1349,49 @@ function createRemote() {
 	};
 }
 //#endregion
+//#region src/resolve.ts
+const message = (error) => error instanceof Error ? error.message : String(error);
+/**
+* Resolve comments one by one, each with the note as a reply. One that fails
+* (deleted, not in this project) doesn't stop the rest.
+*/
+async function resolveComments(remote, session, ids, note) {
+	const result = {
+		resolved: [],
+		failed: [],
+		noteFailed: []
+	};
+	for (const id of [...new Set(ids)]) {
+		try {
+			await remote.setStatus(session.token, id, "resolved");
+		} catch (error) {
+			result.failed.push({
+				id,
+				error: message(error)
+			});
+			continue;
+		}
+		result.resolved.push(id);
+		if (!note?.trim()) continue;
+		try {
+			await remote.reply(session.publicId, session.token, id, note.trim());
+		} catch (error) {
+			result.noteFailed.push({
+				id,
+				error: message(error)
+			});
+		}
+	}
+	return result;
+}
+function formatResolveResult({ resolved, failed, noteFailed }) {
+	return [
+		resolved.length ? `Resolved ${resolved.join(", ")}.` : "",
+		...failed.map((f) => `Couldn't resolve ${f.id}: ${f.error}`),
+		...noteFailed.map((f) => `Resolved ${f.id}, but couldn't post the note: ${f.error}`)
+	].filter(Boolean).join("\n");
+}
+//#endregion
 //#region src/mcp.ts
 /**
 * A Model Context Protocol server over stdio (newline-delimited JSON-RPC),
@@ -1306,6 +1409,7 @@ const PROTOCOL_VERSIONS = [
 	"2024-11-05"
 ];
 const LOGIN$1 = `npx ${PACKAGES.cli}@latest login`;
+const MAX_RESOLVE = 50;
 var ToolError = class extends Error {};
 const text = (value) => ({ content: [{
 	type: "text",
@@ -1346,51 +1450,96 @@ function createMcpServer(options) {
 			token: credential.token
 		};
 	}
+	const DETAIL_HINT = "Call get_comment with an id for the element, DOM, styles, console errors, failed requests and screenshot.";
+	const listSchema = {
+		status: {
+			type: "string",
+			enum: ["open", "resolved"],
+			description: "Defaults to open."
+		},
+		page: {
+			type: "string",
+			description: "Only comments on this path, for example /pricing."
+		},
+		group_by: {
+			type: "string",
+			enum: ["page", "element"],
+			description: "Put related comments together: by page, or by the element they are on (several comments about the same button, heading or text)."
+		},
+		limit: {
+			type: "integer",
+			minimum: 1,
+			maximum: 50
+		}
+	};
+	async function list(args, search) {
+		const { publicId, token } = session();
+		const status = args.status === "resolved" ? "resolved" : "open";
+		const page = await remote.listComments(publicId, token, {
+			status,
+			path: typeof args.page === "string" ? args.page : void 0,
+			search,
+			limit: typeof args.limit === "number" ? args.limit : 20
+		});
+		return text(formatCommentList(page.comments, {
+			status,
+			more: Boolean(page.cursor),
+			order: search ? "best match first" : void 0,
+			groupBy: args.group_by === "page" || args.group_by === "element" ? args.group_by : void 0,
+			detailHint: DETAIL_HINT
+		}));
+	}
 	const tools = [
 		{
 			name: "list_comments",
 			title: "List Nuni comments",
-			description: "List feedback comments left on the live site with Nuni, newest first. Each has an id, the page, the author and the element it is pinned to. Use get_comment for the full context.",
+			description: "List feedback comments left on the live site with Nuni, newest first. Each has an id, the page, the author and the element it is pinned to. Group them by page or element to fix related ones together. Use get_comment for the full context.",
+			inputSchema: {
+				type: "object",
+				properties: listSchema,
+				additionalProperties: false
+			},
+			annotations: { readOnlyHint: true },
+			run: (args) => list(args)
+		},
+		{
+			name: "search_comments",
+			title: "Search Nuni comments",
+			description: "Find comments by the words in them or the author's name, best match first. For example \"typo\", \"button color\" or a person's name.",
 			inputSchema: {
 				type: "object",
 				properties: {
-					status: {
+					query: {
 						type: "string",
-						enum: ["open", "resolved"],
-						description: "Defaults to open."
+						description: "The words to look for."
 					},
-					page: {
-						type: "string",
-						description: "Only comments on this path, for example /pricing."
-					},
-					limit: {
-						type: "integer",
-						minimum: 1,
-						maximum: 50
-					}
+					...listSchema
 				},
+				required: ["query"],
 				additionalProperties: false
 			},
 			annotations: { readOnlyHint: true },
-			async run(args) {
+			run: (args) => list(args, str(args, "query"))
+		},
+		{
+			name: "list_pages",
+			title: "List pages with Nuni comments",
+			description: "The site's pages that have open comments, with how many each has, most first. Use a path with list_comments to work through one page.",
+			inputSchema: {
+				type: "object",
+				properties: {},
+				additionalProperties: false
+			},
+			annotations: { readOnlyHint: true },
+			async run() {
 				const { publicId, token } = session();
-				const status = args.status === "resolved" ? "resolved" : "open";
-				const page = await remote.listComments(publicId, token, {
-					status,
-					path: typeof args.page === "string" ? args.page : void 0,
-					limit: typeof args.limit === "number" ? args.limit : 20
-				});
-				return text(formatCommentList(page.comments, {
-					status,
-					more: Boolean(page.cursor),
-					detailHint: "Call get_comment with an id for the element, DOM, styles, console errors, failed requests and screenshot."
-				}));
+				return text(formatPageList(await remote.listPages(publicId, token)));
 			}
 		},
 		{
 			name: "get_comment",
 			title: "Get a Nuni comment",
-			description: "One comment with everything needed to fix it: the comment, the page link, the element (text, selectors, React component), its HTML and styles, console errors, failed requests and a screenshot.",
+			description: "One comment with everything needed to fix it: the comment, the page link, the element (text, selectors, React component), its HTML and styles, console errors, failed requests, the images the commenter attached and a screenshot.",
 			inputSchema: {
 				type: "object",
 				properties: { id: {
@@ -1409,8 +1558,8 @@ function createMcpServer(options) {
 					type: "text",
 					text: buildCommentPrompt(comment)
 				}];
-				if (comment.screenshotUrl) {
-					const image = await (options.fetchImage ?? fetchImage)(comment.screenshotUrl);
+				for (const url of [...comment.imageUrls ?? [], ...comment.screenshotUrl ? [comment.screenshotUrl] : []]) {
+					const image = await (options.fetchImage ?? fetchImage)(url);
 					if (image) content.push({
 						type: "image",
 						...image
@@ -1470,6 +1619,39 @@ function createMcpServer(options) {
 				return text(`Resolved ${id}.`);
 			}
 		},
+		{
+			name: "resolve_comments",
+			title: "Resolve several Nuni comments",
+			description: "Resolve several comments at once, for example all the ones a single change fixed. The note, if any, is posted as a reply on each. Comments that can't be resolved are listed; the rest still are.",
+			inputSchema: {
+				type: "object",
+				properties: {
+					ids: {
+						type: "array",
+						items: { type: "string" },
+						minItems: 1,
+						maxItems: MAX_RESOLVE
+					},
+					note: {
+						type: "string",
+						description: "Optional: what was changed, posted as a reply on each."
+					}
+				},
+				required: ["ids"],
+				additionalProperties: false
+			},
+			annotations: { idempotentHint: true },
+			async run(args) {
+				const ids = Array.isArray(args.ids) ? args.ids.filter((id) => typeof id === "string") : [];
+				if (!ids.length) throw new ToolError(`"ids" is required`);
+				if (ids.length > MAX_RESOLVE) throw new ToolError(`Resolve up to ${MAX_RESOLVE} comments at a time`);
+				const result = await resolveComments(remote, session(), ids, typeof args.note === "string" ? args.note : void 0);
+				return {
+					...text(formatResolveResult(result)),
+					...result.resolved.length ? {} : { isError: true }
+				};
+			}
+		},
 		{
 			name: "reopen_comment",
 			title: "Reopen a Nuni comment",
@@ -1522,7 +1704,7 @@ function createMcpServer(options) {
 							title: "Nuni",
 							version: options.version
 						},
-						instructions: "Nuni comments are feedback pinned to elements on the live site. List them, read one with its full context, fix the code, then resolve it."
+						instructions: "Nuni comments are feedback pinned to elements on the live site. List them (by page or grouped by element), search them, read one with its full context, fix the code, then resolve it. Resolve several at once when one change fixed them all."
 					};
 					break;
 				}
@@ -1711,12 +1893,15 @@ async function whoami(ctx) {
 async function listComments(ctx, options) {
 	const { publicId, token } = signedIn(ctx);
 	if (options.status && options.status !== "open" && options.status !== "resolved") throw new CommandError(`--status must be open or resolved`);
+	if (options.group && options.group !== "page" && options.group !== "element") throw new CommandError(`--group must be page or element`);
 	const status = options.status ?? "open";
 	const limit = options.limit ? Number(options.limit) : 20;
 	if (!Number.isInteger(limit) || limit < 1) throw new CommandError(`--limit must be a positive number`);
+	const search = options.search?.trim() || void 0;
 	const page = await ctx.remote.listComments(publicId, token, {
 		status,
 		path: options.page,
+		search,
 		limit
 	});
 	if (ctx.json) {
@@ -1726,35 +1911,56 @@ async function listComments(ctx, options) {
 	ctx.out(formatCommentList(page.comments, {
 		status,
 		more: Boolean(page.cursor),
+		order: search ? "best match first" : void 0,
+		groupBy: options.group,
 		detailHint: `Full context: npx ${PACKAGES.cli}@latest comment <id>`
 	}));
 	return 0;
 }
+async function listPages(ctx) {
+	const { publicId, token } = signedIn(ctx);
+	const pages = await ctx.remote.listPages(publicId, token);
+	ctx.out(ctx.json ? JSON.stringify(pages, null, 2) : formatPageList(pages));
+	return 0;
+}
 async function showComment(ctx, id, options) {
 	if (!id) throw new CommandError("Pass a comment id: comment <id>");
 	const { publicId, token } = signedIn(ctx);
 	const comment = await ctx.remote.getComment(publicId, token, id);
 	if (!comment) throw new CommandError(`No comment ${id} in ${publicId}.`);
 	let saved = null;
-	if (options.saveScreenshot && comment.screenshotUrl) {
-		const image = await fetchImage(comment.screenshotUrl);
-		if (image) {
-			const dir = resolve(ctx.cwd, options.saveScreenshot);
+	const imageFiles = [];
+	if (options.saveScreenshot) {
+		const dir = resolve(ctx.cwd, options.saveScreenshot);
+		const files = [...comment.screenshotUrl ? [{
+			url: comment.screenshotUrl,
+			name: `nuni-${comment._id}`
+		}] : [], ...(comment.imageUrls ?? []).map((url, i) => ({
+			url,
+			name: `nuni-${comment._id}-image-${i + 1}`
+		}))];
+		for (const file of files) {
+			const image = await fetchImage(file.url);
+			if (!image) continue;
 			mkdirSync(dir, { recursive: true });
 			const ext = image.mimeType.split("/")[1] ?? "webp";
-			saved = join(dir, `nuni-${comment._id}.${ext}`);
-			writeFileSync(saved, Buffer.from(image.data, "base64"));
+			const path = join(dir, `${file.name}.${ext}`);
+			writeFileSync(path, Buffer.from(image.data, "base64"));
+			if (file.url === comment.screenshotUrl) saved = path;
+			else imageFiles.push(path);
 		}
 	}
 	if (ctx.json) {
 		ctx.out(JSON.stringify({
 			...comment,
-			screenshotFile: saved
+			screenshotFile: saved,
+			imageFiles
 		}, null, 2));
 		return 0;
 	}
 	ctx.out(buildCommentPrompt(comment));
 	if (saved) ctx.out(`\nScreenshot saved to ${saved}`);
+	for (const path of imageFiles) ctx.out(`Image saved to ${path}`);
 	return 0;
 }
 async function reply(ctx, id, body) {
@@ -1767,16 +1973,36 @@ async function reply(ctx, id, body) {
 	}) : `Replied to ${id}.`);
 	return 0;
 }
-async function setStatus(ctx, id, status, note) {
-	const verb = status === "resolved" ? "resolve" : "reopen";
-	if (!id) throw new CommandError(`Pass a comment id: ${verb} <id>`);
-	const { publicId, token } = signedIn(ctx);
-	await ctx.remote.setStatus(token, id, status);
-	if (note?.trim()) await ctx.remote.reply(publicId, token, id, note);
+async function markResolved(ctx, ids, note) {
+	if (!ids.length) throw new CommandError("Pass a comment id: resolve <id...>");
+	const session = signedIn(ctx);
+	if (ids.length === 1) {
+		const id = ids[0];
+		await ctx.remote.setStatus(session.token, id, "resolved");
+		if (note?.trim()) await ctx.remote.reply(session.publicId, session.token, id, note);
+		ctx.out(ctx.json ? JSON.stringify({
+			id,
+			status: "resolved"
+		}) : `Resolved ${id}.`);
+		return 0;
+	}
+	const result = await resolveComments(ctx.remote, session, ids, note);
+	if (ctx.json) ctx.out(JSON.stringify(result, null, 2));
+	else {
+		if (result.resolved.length) ctx.out(`Resolved ${result.resolved.join(", ")}.`);
+		for (const f of result.failed) ctx.err(`Couldn't resolve ${f.id}: ${f.error}`);
+		for (const f of result.noteFailed) ctx.err(`Resolved ${f.id}, but couldn't post the note: ${f.error}`);
+	}
+	return result.failed.length || result.noteFailed.length ? 1 : 0;
+}
+async function reopen(ctx, id) {
+	if (!id) throw new CommandError(`Pass a comment id: reopen <id>`);
+	const { token } = signedIn(ctx);
+	await ctx.remote.setStatus(token, id, "open");
 	ctx.out(ctx.json ? JSON.stringify({
 		id,
-		status
-	}) : `${status === "resolved" ? "Resolved" : "Reopened"} ${id}.`);
+		status: "open"
+	}) : `Reopened ${id}.`);
 	return 0;
 }
 //#endregion
@@ -2006,9 +2232,11 @@ Usage
 
   npx @nuniapp/cli@latest login              sign in to this project's comments
   npx @nuniapp/cli@latest comments [--status open|resolved] [--page /path] [--limit 20]
+                                   [--search "words"] [--group page|element]
+  npx @nuniapp/cli@latest pages
   npx @nuniapp/cli@latest comment <id> [--save-screenshot <dir>]
   npx @nuniapp/cli@latest reply <id> "message"
-  npx @nuniapp/cli@latest resolve <id> [--note "what changed"]
+  npx @nuniapp/cli@latest resolve <id...> [--note "what changed"]
   npx @nuniapp/cli@latest reopen <id>
   npx @nuniapp/cli@latest whoami | logout
   npx @nuniapp/cli@latest mcp                MCP server for coding agents (stdio)
@@ -2018,10 +2246,11 @@ Commands
   prompt    Print the ready-made prompt for Codex, Claude Code, Cursor, etc.
   id        Print a new project ID
   login     Approve this terminal in the Nuni dashboard (works over SSH too)
-  comments  List comments, newest first
+  comments  List comments, newest first (or best match with --search)
+  pages     Pages with open comments, most first
   comment   One comment with the element, DOM, styles, console and screenshot
   reply     Reply in a comment's thread, as the owner
-  resolve   Mark a comment resolved (with an optional note); reopen does the opposite
+  resolve   Mark comments resolved (with an optional note); reopen does the opposite
   mcp       Run the MCP server: claude mcp add nuni -- npx -y @nuniapp/cli@latest mcp
 
 The project comes from --project, $NUNI_PROJECT, or the nuni_ ID in your code.
@@ -2042,6 +2271,8 @@ const OPTIONS = {
 	limit: { type: "string" },
 	"save-screenshot": { type: "string" },
 	note: { type: "string" },
+	search: { type: "string" },
+	group: { type: "string" },
 	json: {
 		type: "boolean",
 		default: false
@@ -2062,6 +2293,7 @@ const ACCOUNT_COMMANDS = /* @__PURE__ */ new Set([
 	"logout",
 	"whoami",
 	"comments",
+	"pages",
 	"comment",
 	"reply",
 	"resolve",
@@ -2169,10 +2401,11 @@ async function runAccountCommand(command, positionals, values, options) {
 			case "logout": return await logout(ctx);
 			case "whoami": return await whoami(ctx);
 			case "comments": return await listComments(ctx, values);
+			case "pages": return await listPages(ctx);
 			case "comment": return await showComment(ctx, arg, { saveScreenshot: values["save-screenshot"] });
 			case "reply": return await reply(ctx, arg, positionals[2]);
-			case "resolve": return await setStatus(ctx, arg, "resolved", values.note);
-			case "reopen": return await setStatus(ctx, arg, "open");
+			case "resolve": return await markResolved(ctx, positionals.slice(1), values.note);
+			case "reopen": return await reopen(ctx, arg);
 			default:
 				await serveStdio(createMcpServer({
 					remote: ctx.remote,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuniapp/cli",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Set up Nuni in any project, and give coding agents its comments: login, list, read and resolve from the terminal or over MCP.",
   "license": "MIT",
   "type": "module",