prq-cli 0.4.0 → 0.6.0

package/README.md

@@ -17,11 +17,11 @@ Requires [GitHub CLI](https://cli.github.com/) (`gh`) to be authenticated.
 ## Quick Start
 
 ```bash
-# Set up config for the current project
-prq init
-
 # See your review queue
 prq
+
+# Interactive mode — navigate with arrow keys, act with shortcuts
+prq -i
 ```
 
 ## Commands
@@ -40,11 +40,23 @@ prq                                        # all repos you have access to
 prq status --repos org/repo1 org/repo2     # specific repos
 prq status --stale-days 7                  # custom stale threshold
 prq status --json                          # machine-readable output
+prq status -i                              # interactive mode
 ```
 
+### Interactive Mode
+
+Run `prq -i` to navigate your queue with keyboard shortcuts:
+
+- **↑↓** navigate between PRs
+- **r** review — open files changed tab
+- **o** open — open PR in browser
+- **n** nudge — post a comment
+- **c** copy URL to clipboard
+- **q** quit
+
 ### `prq open <identifier>`
 
-Open a PR in the browser. Accepts a PR number, `org/repo#number`, or a full GitHub URL.
+Open a PR in the browser.
 
 ```bash
 prq open 482                               # searches your queue for PR #482
@@ -71,14 +83,18 @@ prq nudge 482 --yes                        # skip confirmation
 prq nudge 482 --message "Any updates?"     # custom message
 ```
 
-### `prq init`
+### `prq run <action> <identifier>`
 
-Creates a `.prqrc.json` config file in the current directory.
+Run a custom action defined in your config.
 
 ```bash
-prq init
+prq run checkout 482
 ```
 
+### `prq init`
+
+Creates a `.prqrc.json` config file in the current directory.
+
 ## Configuration
 
 Config is loaded in this order (later overrides earlier):
@@ -92,10 +108,28 @@ Example `.prqrc.json`:
 ```json
 {
   "repos": ["org/repo1", "org/repo2"],
-  "staleDays": 5
+  "staleDays": 5,
+  "actions": {
+    "review": "claude -p '/review {url}'",
+    "checkout": "gh pr checkout {number} --repo {owner}/{repo}"
+  }
 }
 ```
 
+### Custom Actions
+
+Actions are shell command templates with variables:
+
+- `{url}` — full PR URL
+- `{number}` — PR number
+- `{owner}` — repo owner
+- `{repo}` — repo name
+- `{title}` — PR title
+- `{author}` — PR author
+- `{days}` — days since last activity
+
+Default actions (`open`, `review`, `nudge`) can be overridden. Custom actions are available via `prq run <action>` and in interactive mode.
+
 ## License
 
 MIT

package/dist/bin/prq.js

@@ -6478,6 +6478,122 @@ Available actions: ${available}`);
   await executeCommand(command);
 }
 
+// src/commands/skill.ts
+var SKILL_CONTENT = `---
+name: prq
+description: PR review queue manager. Use when the user wants to check their PR review queue, review PRs, nudge stale PRs, or manage code review workflow. Triggers on mentions of "review queue", "PRs waiting", "stale PRs", "what needs review", or "prq".
+---
+
+# PRQ — PR Review Queue
+
+You have access to the \`prq\` CLI tool installed on this machine. Use it to help the user manage their code review queue.
+
+## Step 1: Get the queue
+
+Run this command to get the user's current review queue:
+
+\`\`\`bash
+prq status --json
+\`\`\`
+
+This returns a JSON object with categorized PRs:
+- **needs-re-review** — PRs where the user left a review but new commits were pushed after
+- **requested** — PRs where the user is a requested reviewer
+- **stale** — PRs with no activity for N days
+- **waiting-on-others** — PRs the user authored that are waiting on someone else
+
+## Step 2: Present the queue
+
+Show the results in a clear, scannable format grouped by category. For each PR, show:
+- The category symbol (◆ needs re-review, ● requested, ○ stale, ◇ waiting)
+- The repo and PR number
+- The title
+- The detail (e.g., "new commits since your review 2d ago")
+
+Then ask what the user wants to do.
+
+## Step 3: Act on PRs
+
+When the user asks to act on a PR, check the \`.prqrc.json\` file in the current directory (or \`~/.config/prq/config.json\`) for custom actions:
+
+\`\`\`json
+{
+  "actions": {
+    "review": "/review {url}",
+    "nudge": "shell:prq nudge {number} --yes"
+  }
+}
+\`\`\`
+
+### Action resolution
+
+For each action template:
+- **Starts with \`/\`** — it's a Claude Code skill. Invoke it by running the skill with the interpolated value. For example, \`/review https://github.com/org/repo/pull/123\`
+- **Starts with \`shell:\`** — it's a shell command. Run it with the Bash tool. For example, \`prq nudge 123 --yes\`
+- **Otherwise** — treat it as a prompt. Send it as a message.
+
+### Template variables
+
+Replace these in the action template:
+- \`{url}\` — full PR URL
+- \`{number}\` — PR number
+- \`{owner}\` — repo owner
+- \`{repo}\` — repo name
+- \`{title}\` — PR title
+- \`{author}\` — PR author
+
+### Default actions (if no config found)
+
+If no actions are configured, use these defaults:
+- **review** — invoke \`/review {url}\` if the /review skill exists, otherwise run \`prq review {number}\` to open files changed in browser
+- **nudge** — run \`prq nudge {number} --yes\`
+- **open** — run \`prq open {number}\`
+
+## Step 4: Batch operations
+
+If the user says things like "review all needs-re-review PRs" or "nudge all stale PRs":
+
+1. Filter the queue JSON by the requested category
+2. Confirm the list with the user: "I'll review these 3 PRs: #2439, #2380, #2352. Proceed?"
+3. Execute the action on each PR sequentially
+
+## Examples
+
+**User:** "check my review queue"
+→ Run \`prq status --json\`, present results, ask what to do
+
+**User:** "review 2439"
+→ Look up action for "review", interpolate with PR data, execute
+
+**User:** "nudge all stale PRs"
+→ Filter stale PRs from queue, confirm, run nudge on each
+
+**User:** "what PRs are waiting on me?"
+→ Run \`prq status --json\`, show only needs-re-review and requested categories
+
+**User:** "/prq" with no context
+→ Run \`prq status --json\`, present full queue, ask what to do
+`;
+function skillCommand(global) {
+  if (global) {
+    const fs2 = __require("node:fs");
+    const path2 = __require("node:path");
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+    const skillDir = path2.join(home, ".claude", "skills", "prq");
+    const skillPath = path2.join(skillDir, "SKILL.md");
+    fs2.mkdirSync(skillDir, { recursive: true });
+    fs2.writeFileSync(skillPath, SKILL_CONTENT);
+    console.log(`Installed to ${skillPath}`);
+  } else {
+    const fs2 = __require("node:fs");
+    const skillDir = ".claude/skills/prq";
+    const skillPath = `${skillDir}/SKILL.md`;
+    fs2.mkdirSync(skillDir, { recursive: true });
+    fs2.writeFileSync(skillPath, SKILL_CONTENT);
+    console.log(`Installed to ${skillPath}`);
+  }
+}
+
 // src/categorize.ts
 function timeAgo(dateStr) {
   const now = Date.now();
@@ -6583,7 +6699,7 @@ function categorize(reviewedPRs, requestedPRs, authoredPRs, staleDays) {
   return results;
 }
 
-// src/output.ts
+// src/interactive.ts
 var CATEGORY_CONFIG = {
   "needs-re-review": {
     icon: "◆",
@@ -6604,6 +6720,198 @@ var CATEGORY_ORDER = [
   "stale",
   "waiting-on-others"
 ];
+function toResolvedPR(pr) {
+  const [owner, repo] = pr.repo.split("/");
+  return {
+    owner,
+    repo,
+    number: pr.number,
+    url: pr.url,
+    title: pr.title,
+    author: pr.author,
+    updatedAt: pr.updatedAt
+  };
+}
+function render(result, selectedIndex, message) {
+  process.stdout.write("\x1B[2J\x1B[H");
+  const lines = [];
+  lines.push(source_default.bold(` PRQ Status for ${result.user}`));
+  lines.push(source_default.dim(` ${"─".repeat(50)}`));
+  const grouped = new Map;
+  for (const pr of result.prs) {
+    const list = grouped.get(pr.category) ?? [];
+    list.push(pr);
+    grouped.set(pr.category, list);
+  }
+  let flatIndex = 0;
+  for (const category of CATEGORY_ORDER) {
+    const prs = grouped.get(category);
+    if (!prs || prs.length === 0)
+      continue;
+    const config = CATEGORY_CONFIG[category];
+    lines.push("");
+    lines.push(` ${config.color(`${config.icon} ${config.label}`)} ${source_default.dim(`(${prs.length})`)}`);
+    for (const pr of prs) {
+      const isSelected = flatIndex === selectedIndex;
+      const arrow = isSelected ? source_default.yellow("›") : " ";
+      const draft = pr.isDraft ? source_default.dim(" [draft]") : "";
+      const maxTitle = 50;
+      const title = pr.title.length > maxTitle ? `${pr.title.slice(0, maxTitle - 3)}...` : pr.title;
+      if (isSelected) {
+        const ref = source_default.white(`#${pr.number}`);
+        lines.push(` ${arrow} ${ref}  ${source_default.white(title)}${draft}`);
+        lines.push(`     ${source_default.dim("↳")} ${source_default.dim(pr.detail)}`);
+      } else {
+        const ref = source_default.dim(`#${pr.number}`);
+        lines.push(` ${arrow} ${ref}  ${source_default.dim(title)}${draft}`);
+        lines.push(`     ${source_default.dim("↳")} ${source_default.dim(pr.detail)}`);
+      }
+      flatIndex++;
+    }
+  }
+  if (result.prs.length === 0) {
+    lines.push("");
+    lines.push(source_default.green("  All clear! No PRs need your attention."));
+  }
+  lines.push("");
+  lines.push(source_default.dim(` ${"─".repeat(50)}`));
+  lines.push("");
+  lines.push(` ${source_default.dim("↑↓")} navigate  ${source_default.white("r")} review  ${source_default.white("o")} open  ${source_default.white("n")} nudge  ${source_default.white("c")} copy url  ${source_default.white("q")} quit`);
+  if (message) {
+    lines.push("");
+    lines.push(` ${message}`);
+  }
+  process.stdout.write(lines.join(`
+`));
+}
+async function interactiveMode(result, config) {
+  if (result.prs.length === 0) {
+    console.log(source_default.green(`
+  All clear! No PRs need your attention.
+`));
+    return;
+  }
+  let selectedIndex = 0;
+  let message = "";
+  const total = result.prs.length;
+  if (!process.stdin.isTTY) {
+    process.stdout.write(`Interactive mode requires a terminal. Use prq status instead.
+`);
+    return;
+  }
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+  process.stdin.setEncoding("utf8");
+  process.stdout.write("\x1B[?25l");
+  render(result, selectedIndex, message);
+  return new Promise((resolve) => {
+    const cleanup = () => {
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdin.removeAllListeners("data");
+      process.stdout.write("\x1B[?25h\x1B[2J\x1B[H");
+    };
+    process.stdin.on("data", async (key) => {
+      const pr = result.prs[selectedIndex];
+      switch (key) {
+        case "q":
+        case "\x03":
+          cleanup();
+          resolve();
+          return;
+        case "\x1B[A":
+          selectedIndex = Math.max(0, selectedIndex - 1);
+          message = "";
+          break;
+        case "\x1B[B":
+          selectedIndex = Math.min(total - 1, selectedIndex + 1);
+          message = "";
+          break;
+        case "o": {
+          const template = getAction("open", config);
+          if (template) {
+            const cmd = interpolate(template, buildContext(toResolvedPR(pr)));
+            message = source_default.dim(`opening ${pr.repo}#${pr.number}...`);
+            render(result, selectedIndex, message);
+            try {
+              await executeCommand(cmd);
+              message = source_default.green(`opened ${pr.repo}#${pr.number}`);
+            } catch {
+              message = source_default.red("failed to open");
+            }
+          }
+          break;
+        }
+        case "r": {
+          const template = getAction("review", config);
+          if (template) {
+            const cmd = interpolate(template, buildContext(toResolvedPR(pr)));
+            message = source_default.dim(`opening review for ${pr.repo}#${pr.number}...`);
+            render(result, selectedIndex, message);
+            try {
+              await executeCommand(cmd);
+              message = source_default.green(`opened review for ${pr.repo}#${pr.number}`);
+            } catch {
+              message = source_default.red("failed to open review");
+            }
+          }
+          break;
+        }
+        case "n": {
+          const template = getAction("nudge", config);
+          if (template) {
+            const cmd = interpolate(template, buildContext(toResolvedPR(pr)));
+            message = source_default.dim(`nudging ${pr.repo}#${pr.number}...`);
+            render(result, selectedIndex, message);
+            try {
+              await executeCommand(cmd);
+              message = source_default.green(`nudged ${pr.repo}#${pr.number}`);
+            } catch {
+              message = source_default.red("failed to nudge");
+            }
+          }
+          break;
+        }
+        case "c": {
+          const url = pr.url;
+          try {
+            const proc = process.platform === "darwin" ? "pbcopy" : process.platform === "linux" ? "xclip -selection clipboard" : "clip";
+            await executeCommand(`echo "${url}" | ${proc}`);
+            message = source_default.green("url copied");
+          } catch {
+            message = source_default.dim(url);
+          }
+          break;
+        }
+        default:
+          break;
+      }
+      render(result, selectedIndex, message);
+    });
+  });
+}
+
+// src/output.ts
+var CATEGORY_CONFIG2 = {
+  "needs-re-review": {
+    icon: "◆",
+    label: "Needs Re-review",
+    color: source_default.yellow
+  },
+  requested: { icon: "●", label: "Requested Reviews", color: source_default.green },
+  stale: { icon: "○", label: "Stale", color: source_default.red },
+  "waiting-on-others": {
+    icon: "◇",
+    label: "Your PRs Waiting",
+    color: source_default.dim
+  }
+};
+var CATEGORY_ORDER2 = [
+  "needs-re-review",
+  "requested",
+  "stale",
+  "waiting-on-others"
+];
 function formatPR(pr) {
   const draft = pr.isDraft ? source_default.dim(" [draft]") : "";
   const prRef = source_default.cyan(`${pr.repo}#${pr.number}`);
@@ -6627,12 +6935,12 @@ function formatStatus(result) {
     grouped.set(pr.category, list);
   }
   let hasContent = false;
-  for (const category of CATEGORY_ORDER) {
+  for (const category of CATEGORY_ORDER2) {
     const prs = grouped.get(category);
     if (!prs || prs.length === 0)
       continue;
     hasContent = true;
-    const config = CATEGORY_CONFIG[category];
+    const config = CATEGORY_CONFIG2[category];
     lines.push("");
     lines.push(` ${config.color(`${config.icon} ${config.label}`)} ${source_default.dim(`(${prs.length})`)}`);
     for (const pr of prs) {
@@ -6656,7 +6964,7 @@ function formatStatus(result) {
 }
 
 // src/commands/status.ts
-async function statusCommand(config, json) {
+async function statusCommand(config, json, interactive) {
   const user = config.user ?? await getAuthenticatedUser();
   process.stderr.write(`Fetching PRs for ${user}...
 `);
@@ -6677,6 +6985,8 @@ async function statusCommand(config, json) {
   if (json) {
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
+  } else if (interactive && process.stdin.isTTY) {
+    await interactiveMode(result, config);
   } else {
     process.stdout.write(formatStatus(result));
   }
@@ -10699,12 +11009,12 @@ function getVersion() {
 function createCLI() {
   const program2 = new Command;
   program2.name("prq").description("PR Queue — see what code reviews need your attention").version(getVersion());
-  program2.command("status", { isDefault: true }).description("Show PRs needing your attention").option("-r, --repos <repos...>", "Filter to specific repos (owner/name)").option("-s, --stale-days <days>", "Days of inactivity to consider stale", "3").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("status", { isDefault: true }).description("Show PRs needing your attention").option("-r, --repos <repos...>", "Filter to specific repos (owner/name)").option("-s, --stale-days <days>", "Days of inactivity to consider stale", "3").option("--json", "Output as JSON").option("-i, --interactive", "Interactive mode with keyboard shortcuts").action(async (opts) => {
     const config = loadConfig({
       repos: opts.repos,
       staleDays: opts.staleDays ? parseInt(opts.staleDays, 10) : undefined
     });
-    await statusCommand(config, opts.json ?? false);
+    await statusCommand(config, opts.json ?? false, opts.interactive ?? false);
   });
   program2.command("open <identifier>").description("Open a PR in the browser").action(async (identifier) => {
     const config = loadConfig({});
@@ -10725,6 +11035,9 @@ function createCLI() {
     const config = loadConfig({});
     await runCommand(action, identifier, config);
   });
+  program2.command("skill").description("Install the /prq skill for Claude Code").option("-g, --global", "Install globally (~/.claude/skills/prq/)").action((opts) => {
+    skillCommand(opts.global ?? false);
+  });
   program2.command("init").description("Create config file interactively").action(async () => {
     await initCommand();
   });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "prq-cli",
-	"version": "0.4.0",
+	"version": "0.6.0",
 	"description": "PR Queue — see what code reviews need your attention",
 	"type": "module",
 	"bin": {