agent-reviews 0.4.0 → 0.5.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-reviews",
   "description": "Manage GitHub PR review comments from Claude Code. Automatically triage, fix, and respond to bot findings.",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "author": {
     "name": "Paul Bakaus",
     "url": "https://github.com/pbakaus"

package/README.md

@@ -4,6 +4,14 @@ Manage GitHub PR review comments from the terminal and from AI coding agents.
 
 PR review bots (Copilot, Cursor Bugbot, CodeRabbit, etc.) leave inline comments on your pull requests. agent-reviews gives you a CLI to list, filter, reply to, and watch those comments, plus a Claude Code skill that automates the entire triage-fix-reply loop.
 
+## Why
+
+**`gh` CLI is fragile for review comments.** Agents frequently get the syntax wrong, fail to paginate, and can't reliably detect whether a comment has been replied to. agent-reviews provides a single, purpose-built interface that handles all of this correctly.
+
+**Bot reviews create a doom loop.** You fix one round of findings, push, and new comments appear. Fix those, push again, more comments. This cycle can eat hours. The included skill solves it with an integrated watcher that keeps fixing and replying until the bots go quiet.
+
+**Works in Claude Code for the web.** Most solutions rely on local tooling that isn't available in cloud environments. agent-reviews works everywhere Claude Code runs, so you can kick off a session in your browser, let it resolve all bot findings autonomously, and come back to a clean PR.
+
 ## Install
 
 ### CLI (npm)
@@ -90,6 +98,7 @@ agent-reviews --pr 42
 | `--json` | `-j` | JSON output |
 | `--bots-only` | `-b` | Only bot comments |
 | `--humans-only` | `-H` | Only human comments |
+| `--expanded` | `-e` | Show full detail for each listed comment |
 | `--watch` | `-w` | Poll for new comments |
 | `--interval <sec>` | `-i` | Poll interval in seconds (default: 30) |
 | `--timeout <sec>` | | Inactivity timeout in seconds (default: 600) |
@@ -150,6 +159,12 @@ Each comment displays its reply status:
 
 Polls the GitHub API at a configurable interval and reports new comments as they appear. Outputs both formatted text and JSON for AI agent consumption. Exits automatically after a configurable inactivity timeout (default: 10 minutes).
 
+## FAQ
+
+### How can I make the skill review human comments as well?
+
+The skill defaults to `--bots-only` because that's the most common use case, but it's easy to change. Open your local copy of `SKILL.md` (inside `skills/agent-reviews/`) and remove the `--bots-only` flag from the commands in Steps 2, 6, and anywhere else it appears. The skill will then fetch and process all comments, regardless of author.
+
 ## License
 
 MIT

package/bin/agent-reviews.js

@@ -63,6 +63,7 @@ function parseArgs() {
     detail: null,
     help: false,
     version: false,
+    expanded: false,
     watch: false,
     watchInterval: 30,
     watchTimeout: 600,
@@ -118,6 +119,10 @@ function parseArgs() {
       case "--timeout":
         result.watchTimeout = Number.parseInt(args[++i], 10);
         break;
+      case "--expanded":
+      case "-e":
+        result.expanded = true;
+        break;
       case "--help":
       case "-h":
         result.help = true;
@@ -146,6 +151,7 @@ ${colors.bright}Usage:${colors.reset}
   agent-reviews --unanswered           List comments without replies
   agent-reviews --reply <id> "msg"     Reply to a specific comment
   agent-reviews --detail <id>          Show full detail for a comment
+  agent-reviews --expanded             Show full detail for each comment
   agent-reviews --watch                Watch for new comments (poll mode)
   agent-reviews --json                 Output as JSON for scripting
 
@@ -158,6 +164,7 @@ ${colors.bright}Options:${colors.reset}
   -j, --json         Output as JSON instead of formatted text
   -b, --bots-only    Only show comments from bots
   -H, --humans-only  Only show comments from humans
+  -e, --expanded     Show full detail (body, diff hunk, replies) for each comment
   -h, --help         Show this help
   -v, --version      Show version
 
@@ -170,6 +177,7 @@ ${colors.bright}Examples:${colors.reset}
   agent-reviews                              # Show all comments
   agent-reviews -u                           # Show unresolved only
   agent-reviews -a --bots-only               # Unanswered bot comments
+  agent-reviews -a --bots-only --expanded    # Full detail for unanswered bot comments
   agent-reviews --reply 12345 "Fixed!"       # Reply to comment #12345
   agent-reviews --detail 12345               # Full detail for a comment
   agent-reviews --detail 12345 --json        # Detail as JSON

package/lib/comments.js

@@ -130,6 +130,40 @@ function isBot(username) {
   );
 }
 
+// ---------------------------------------------------------------------------
+// Body cleanup
+// ---------------------------------------------------------------------------
+
+/**
+ * Strip bot boilerplate from comment bodies:
+ *  - HTML comments (<!-- ... -->)
+ *  - Cursor "Fix in Cursor" / "Fix in Web" button blocks
+ *  - "Additional Locations" <details> blocks
+ *  - Collapse leftover blank lines
+ */
+function cleanBody(body) {
+  if (!body) return body;
+
+  let cleaned = body;
+
+  // Remove HTML comments (single and multi-line)
+  cleaned = cleaned.replace(/<!--[\s\S]*?-->/g, "");
+
+  // Remove <details> blocks containing "Additional Locations"
+  cleaned = cleaned.replace(
+    /<details>\s*<summary>\s*Additional Locations[\s\S]*?<\/details>/gi,
+    ""
+  );
+
+  // Remove <p> blocks containing cursor.com links
+  cleaned = cleaned.replace(/<p>\s*<a [^>]*cursor\.com[\s\S]*?<\/p>/gi, "");
+
+  // Collapse runs of 3+ newlines into 2
+  cleaned = cleaned.replace(/\n{3,}/g, "\n\n");
+
+  return cleaned.trim();
+}
+
 // ---------------------------------------------------------------------------
 // Processing
 // ---------------------------------------------------------------------------
@@ -148,7 +182,7 @@ function processComments(data, options = {}) {
       repliesMap.get(comment.in_reply_to_id).push({
         id: comment.id,
         user: comment.user?.login,
-        body: comment.body,
+        body: cleanBody(comment.body),
         createdAt: comment.created_at,
         isBot: isBot(comment.user?.login),
       });
@@ -174,7 +208,7 @@ function processComments(data, options = {}) {
       path: comment.path,
       line: comment.line || comment.original_line,
       diffHunk: comment.diff_hunk || null,
-      body: comment.body,
+      body: cleanBody(comment.body),
       createdAt: comment.created_at,
       updatedAt: comment.updated_at,
       url: comment.html_url,
@@ -197,7 +231,7 @@ function processComments(data, options = {}) {
       path: null,
       line: null,
       diffHunk: null,
-      body: comment.body,
+      body: cleanBody(comment.body),
       createdAt: comment.created_at,
       updatedAt: comment.updated_at,
       url: comment.html_url,
@@ -221,7 +255,7 @@ function processComments(data, options = {}) {
       path: null,
       line: null,
       diffHunk: null,
-      body: review.body,
+      body: cleanBody(review.body),
       state: review.state,
       createdAt: review.submitted_at,
       updatedAt: review.submitted_at,
@@ -330,5 +364,6 @@ module.exports = {
   replyToComment,
   isBot,
   isMetaComment,
+  cleanBody,
   DEFAULT_META_FILTERS,
 };

package/lib/format.js

@@ -152,7 +152,9 @@ function formatOutput(comments, options) {
   }
 
   const header = `${colors.bright}Found ${comments.length} comment${comments.length === 1 ? "" : "s"}${colors.reset}\n`;
-  const formatted = comments.map((c) => formatComment(c)).join("\n\n");
+  const formatter = options.expanded ? formatDetailedComment : formatComment;
+  const separator = options.expanded ? "\n\n" + "=".repeat(60) + "\n\n" : "\n\n";
+  const formatted = comments.map((c) => formatter(c)).join(separator);
 
   return `${header}\n${formatted}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-reviews",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "CLI and Claude Code skill for managing GitHub PR review comments. List, filter, reply, and watch for bot findings.",
   "license": "MIT",
   "author": "Paul Bakaus",
@@ -28,9 +28,14 @@
     ".claude-plugin/"
   ],
   "scripts": {
-    "build:skill": "node scripts/build-skill.js"
+    "build:skill": "node scripts/build-skill.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "engines": {
     "node": ">=18"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
   }
 }

package/skills/agent-reviews/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: Requires git and gh (GitHub CLI) installed. Designed for Claude Code.
 metadata:
   author: pbakaus
-  version: "0.4.0"
+  version: "0.5.1"
   homepage: https://github.com/pbakaus/agent-reviews
 ---
 
@@ -21,29 +21,21 @@ gh pr view --json number,url,headRefName
 
 If no PR exists, notify the user and exit.
 
-### Step 2: Fetch All Bot Comments
+### Step 2: Fetch All Bot Comments (Expanded)
 
 ```bash
-scripts/agent-reviews.js --bots-only --unanswered
+scripts/agent-reviews.js --bots-only --unanswered --expanded
 ```
 
-This shows only unanswered bot comments. Each comment shows its ID in brackets (e.g., `[12345678]`), the author, file path, and a truncated body.
+This shows only unanswered bot comments with full detail: complete comment body (no truncation), diff hunk (code context), and all replies. Each comment shows its ID in brackets (e.g., `[12345678]`).
 
 If zero comments are returned, print "No unanswered bot comments found" and skip to Phase 2.
 
 ### Step 3: Process Each Unanswered Comment
 
-For each comment where `hasAnyReply === false`:
+For each comment from the expanded output:
 
-#### A. Get Full Detail
-
-```bash
-scripts/agent-reviews.js --detail <comment_id>
-```
-
-This shows the full comment body (no truncation), the diff hunk (code context), and all replies. Use this instead of `gh` CLI for comment details.
-
-#### B. Evaluate the Finding
+#### A. Evaluate the Finding
 
 Read the referenced code and determine:
 
@@ -72,7 +64,7 @@ Read the referenced code and determine:
 - Multiple valid interpretations exist
 - The fix could have unintended side effects
 
-#### C. Act on Evaluation
+#### B. Act on Evaluation
 
 **If TRUE POSITIVE:** Fix the code. Track the comment ID and a brief description of the fix.
 
@@ -145,8 +137,8 @@ Use `TaskOutput` to wait for the watcher to complete (blocks up to 12 minutes).
 ### Step 8: Process New Comments (if any)
 
 If the watcher found new comments:
-1. Process them exactly as in Phase 1, Steps 3-5
-2. Use `--detail <id>` to read each new comment
+1. Use `--detail <id>` to read each new comment's full detail
+2. Process them exactly as in Phase 1, Steps 3-5
 
 If no new comments were found, move to the summary.
 

package/skills/agent-reviews/scripts/agent-reviews.js

@@ -63,6 +63,7 @@ function parseArgs() {
     detail: null,
     help: false,
     version: false,
+    expanded: false,
     watch: false,
     watchInterval: 30,
     watchTimeout: 600,
@@ -118,6 +119,10 @@ function parseArgs() {
       case "--timeout":
         result.watchTimeout = Number.parseInt(args[++i], 10);
         break;
+      case "--expanded":
+      case "-e":
+        result.expanded = true;
+        break;
       case "--help":
       case "-h":
         result.help = true;
@@ -146,6 +151,7 @@ ${colors.bright}Usage:${colors.reset}
   agent-reviews --unanswered           List comments without replies
   agent-reviews --reply <id> "msg"     Reply to a specific comment
   agent-reviews --detail <id>          Show full detail for a comment
+  agent-reviews --expanded             Show full detail for each comment
   agent-reviews --watch                Watch for new comments (poll mode)
   agent-reviews --json                 Output as JSON for scripting
 
@@ -158,6 +164,7 @@ ${colors.bright}Options:${colors.reset}
   -j, --json         Output as JSON instead of formatted text
   -b, --bots-only    Only show comments from bots
   -H, --humans-only  Only show comments from humans
+  -e, --expanded     Show full detail (body, diff hunk, replies) for each comment
   -h, --help         Show this help
   -v, --version      Show version
 
@@ -170,6 +177,7 @@ ${colors.bright}Examples:${colors.reset}
   agent-reviews                              # Show all comments
   agent-reviews -u                           # Show unresolved only
   agent-reviews -a --bots-only               # Unanswered bot comments
+  agent-reviews -a --bots-only --expanded    # Full detail for unanswered bot comments
   agent-reviews --reply 12345 "Fixed!"       # Reply to comment #12345
   agent-reviews --detail 12345               # Full detail for a comment
   agent-reviews --detail 12345 --json        # Detail as JSON
@@ -320,7 +328,7 @@ async function main() {
   const options = parseArgs();
 
   if (options.version) {
-    console.log("0.4.0");
+    console.log("0.5.1");
     process.exit(0);
   }
 

package/skills/agent-reviews/scripts/comments.js

@@ -130,6 +130,40 @@ function isBot(username) {
   );
 }
 
+// ---------------------------------------------------------------------------
+// Body cleanup
+// ---------------------------------------------------------------------------
+
+/**
+ * Strip bot boilerplate from comment bodies:
+ *  - HTML comments (<!-- ... -->)
+ *  - Cursor "Fix in Cursor" / "Fix in Web" button blocks
+ *  - "Additional Locations" <details> blocks
+ *  - Collapse leftover blank lines
+ */
+function cleanBody(body) {
+  if (!body) return body;
+
+  let cleaned = body;
+
+  // Remove HTML comments (single and multi-line)
+  cleaned = cleaned.replace(/<!--[\s\S]*?-->/g, "");
+
+  // Remove <details> blocks containing "Additional Locations"
+  cleaned = cleaned.replace(
+    /<details>\s*<summary>\s*Additional Locations[\s\S]*?<\/details>/gi,
+    ""
+  );
+
+  // Remove <p> blocks containing cursor.com links
+  cleaned = cleaned.replace(/<p>\s*<a [^>]*cursor\.com[\s\S]*?<\/p>/gi, "");
+
+  // Collapse runs of 3+ newlines into 2
+  cleaned = cleaned.replace(/\n{3,}/g, "\n\n");
+
+  return cleaned.trim();
+}
+
 // ---------------------------------------------------------------------------
 // Processing
 // ---------------------------------------------------------------------------
@@ -148,7 +182,7 @@ function processComments(data, options = {}) {
       repliesMap.get(comment.in_reply_to_id).push({
         id: comment.id,
         user: comment.user?.login,
-        body: comment.body,
+        body: cleanBody(comment.body),
         createdAt: comment.created_at,
         isBot: isBot(comment.user?.login),
       });
@@ -174,7 +208,7 @@ function processComments(data, options = {}) {
       path: comment.path,
       line: comment.line || comment.original_line,
       diffHunk: comment.diff_hunk || null,
-      body: comment.body,
+      body: cleanBody(comment.body),
       createdAt: comment.created_at,
       updatedAt: comment.updated_at,
       url: comment.html_url,
@@ -197,7 +231,7 @@ function processComments(data, options = {}) {
       path: null,
       line: null,
       diffHunk: null,
-      body: comment.body,
+      body: cleanBody(comment.body),
       createdAt: comment.created_at,
       updatedAt: comment.updated_at,
       url: comment.html_url,
@@ -221,7 +255,7 @@ function processComments(data, options = {}) {
       path: null,
       line: null,
       diffHunk: null,
-      body: review.body,
+      body: cleanBody(review.body),
       state: review.state,
       createdAt: review.submitted_at,
       updatedAt: review.submitted_at,
@@ -330,5 +364,6 @@ module.exports = {
   replyToComment,
   isBot,
   isMetaComment,
+  cleanBody,
   DEFAULT_META_FILTERS,
 };

package/skills/agent-reviews/scripts/format.js

@@ -152,7 +152,9 @@ function formatOutput(comments, options) {
   }
 
   const header = `${colors.bright}Found ${comments.length} comment${comments.length === 1 ? "" : "s"}${colors.reset}\n`;
-  const formatted = comments.map((c) => formatComment(c)).join("\n\n");
+  const formatter = options.expanded ? formatDetailedComment : formatComment;
+  const separator = options.expanded ? "\n\n" + "=".repeat(60) + "\n\n" : "\n\n";
+  const formatted = comments.map((c) => formatter(c)).join(separator);
 
   return `${header}\n${formatted}`;
 }