prq-cli 0.3.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

@@ -6411,40 +6411,71 @@ async function nudgeCommand(identifier, config, options) {
   console.log(source_default.green(`  Comment posted on ${label}`));
 }
 
-// src/platform.ts
+// src/actions.ts
 import { spawn } from "node:child_process";
-function openUrl(url) {
-  return new Promise((resolve, reject) => {
-    const cmd = process.platform === "darwin" ? "open" : process.platform === "linux" ? "xdg-open" : process.platform === "win32" ? "cmd" : null;
-    if (!cmd) {
-      reject(new Error(`Unsupported platform: ${process.platform}`));
-      return;
+var DEFAULT_ACTIONS = {
+  open: "open {url}",
+  review: "open {url}/files",
+  nudge: "gh pr comment {number} --repo {owner}/{repo} --body 'Hey @{author}, is this PR still active? No activity for {days} days.'"
+};
+function getAction(name, config) {
+  return config.actions[name] ?? DEFAULT_ACTIONS[name];
+}
+function listActions(config) {
+  return { ...DEFAULT_ACTIONS, ...config.actions };
+}
+function buildContext(pr) {
+  const days = Math.floor((Date.now() - new Date(pr.updatedAt || Date.now()).getTime()) / 86400000);
+  return {
+    url: pr.url,
+    number: pr.number,
+    owner: pr.owner,
+    repo: pr.repo,
+    fullRepo: `${pr.owner}/${pr.repo}`,
+    title: pr.title,
+    author: pr.author,
+    days
+  };
+}
+function interpolate(template, context) {
+  return template.replace(/\{(\w+)\}/g, (match, key) => {
+    if (key in context) {
+      return String(context[key]);
     }
-    const args = process.platform === "win32" ? ["/c", "start", url] : [url];
-    const child = spawn(cmd, args, { stdio: "ignore", detached: true });
-    child.unref();
-    child.on("error", reject);
-    child.on("close", () => resolve());
+    return match;
   });
 }
-
-// src/commands/open.ts
-async function openCommand(identifier, config) {
-  const pr = await resolveIdentifier(identifier, config);
-  const label = `${pr.owner}/${pr.repo}#${pr.number}`;
-  process.stderr.write(source_default.dim(`Opening ${label}...
-`));
-  await openUrl(pr.url);
+function executeCommand(command) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, {
+      shell: true,
+      stdio: "inherit"
+    });
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0)
+        resolve();
+      else
+        reject(new Error(`Command exited with code ${code}`));
+    });
+  });
 }
 
-// src/commands/review.ts
-async function reviewCommand(identifier, config) {
+// src/commands/run.ts
+async function runCommand(action, identifier, config) {
+  const template = getAction(action, config);
+  if (!template) {
+    const available = Object.keys(listActions(config)).join(", ");
+    throw new Error(`Unknown action: "${action}"
+Available actions: ${available}`);
+  }
   const pr = await resolveIdentifier(identifier, config);
+  const context = buildContext(pr);
+  const command = interpolate(template, context);
   const label = `${pr.owner}/${pr.repo}#${pr.number}`;
-  const filesUrl = `${pr.url}/files`;
-  process.stderr.write(source_default.dim(`Opening review for ${label}...
+  process.stderr.write(source_default.dim(`${label} → ${action}: ${command}
 `));
-  await openUrl(filesUrl);
+  await executeCommand(command);
 }
 
 // src/categorize.ts
@@ -6552,7 +6583,7 @@ function categorize(reviewedPRs, requestedPRs, authoredPRs, staleDays) {
   return results;
 }
 
-// src/output.ts
+// src/interactive.ts
 var CATEGORY_CONFIG = {
   "needs-re-review": {
     icon: "◆",
@@ -6573,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}`);
@@ -6596,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) {
@@ -6625,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}...
 `);
@@ -6646,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));
   }
@@ -10632,7 +10857,8 @@ var NEVER = INVALID;
 var configSchema = exports_external.object({
   repos: exports_external.array(exports_external.string()).default([]),
   staleDays: exports_external.number().default(3),
-  user: exports_external.string().optional()
+  user: exports_external.string().optional(),
+  actions: exports_external.record(exports_external.string()).default({})
 });
 function loadConfig(cliOverrides) {
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
@@ -10667,20 +10893,20 @@ 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({});
-    await openCommand(identifier, config);
+    await runCommand("open", identifier, config);
   });
   program2.command("review <identifier>").description("Open PR files changed tab for review").action(async (identifier) => {
     const config = loadConfig({});
-    await reviewCommand(identifier, config);
+    await runCommand("review", identifier, config);
   });
   program2.command("nudge <identifier>").description("Post a nudge comment on a PR").option("-m, --message <msg>", "Custom nudge message").option("-y, --yes", "Skip confirmation").action(async (identifier, opts) => {
     const config = loadConfig({});
@@ -10689,6 +10915,10 @@ function createCLI() {
       yes: opts.yes ?? false
     });
   });
+  program2.command("run <action> <identifier>").description("Run a custom action on a PR").action(async (action, identifier) => {
+    const config = loadConfig({});
+    await runCommand(action, identifier, config);
+  });
   program2.command("init").description("Create config file interactively").action(async () => {
     await initCommand();
   });

package/package.json

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