prq-cli 0.4.0 → 0.5.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

@@ -6583,7 +6583,7 @@ function categorize(reviewedPRs, requestedPRs, authoredPRs, staleDays) {
   return results;
 }
 
-// src/output.ts
+// src/interactive.ts
 var CATEGORY_CONFIG = {
   "needs-re-review": {
     icon: "◆",
@@ -6604,6 +6604,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 +6819,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 +6848,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 +6869,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 +10893,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({});

package/package.json

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