prq-cli 0.7.0 → 0.8.0

package/README.md

@@ -95,19 +95,21 @@ prq skill --global   # install globally
 
 ## Pluggable Actions
 
-PRQ doesn't force a workflow. Every action is a configurable shell command template. Override the defaults or add your own in `.prqrc.json`:
+PRQ doesn't force a workflow. Every action is a configurable shell command template — inline commands or scripts. Override the defaults or add your own in `.prqrc.json`.
+
+Actions run with full terminal control. When you trigger an action, prq suspends its TUI, the command takes over the screen (interactive tools like Claude Code work as normal), and prq resumes when the command exits.
 
 ### Use Claude Code for reviews
 
 ```json
 {
   "actions": {
-    "review": "claude -p '/review {url}'"
+    "review": "claude '/review {url}'"
   }
 }
 ```
 
-Now `prq review 482` dispatches to Claude Code.
+Now `prq review 482` opens an interactive Claude Code session.
 
 ### Use Codex for reviews
 
@@ -119,6 +121,18 @@ Now `prq review 482` dispatches to Claude Code.
 }
 ```
 
+### Use a script for complex workflows
+
+```json
+{
+  "actions": {
+    "review": "./scripts/review.sh {number} {url}"
+  }
+}
+```
+
+The script handles its own logic — session management, resuming, branching, whatever you need.
+
 ### Use gh CLI to checkout
 
 ```json
@@ -143,9 +157,11 @@ With no config, `prq review` opens the files changed tab and `prq open` opens th
 | `{number}` | `482` |
 | `{owner}` | `org` |
 | `{repo}` | `repo` |
+| `{fullRepo}` | `org/repo` |
 | `{title}` | `fix: handle edge case` |
 | `{author}` | `alice` |
 | `{days}` | `5` |
+| `{category}` | `needs-re-review` |
 
 ## Agent & Automation
 
@@ -196,7 +212,7 @@ Full example:
   "repos": ["org/repo1", "org/repo2"],
   "staleDays": 5,
   "actions": {
-    "review": "claude -p '/review {url}'",
+    "review": "claude '/review {url}'",
     "checkout": "gh pr checkout {number} --repo {owner}/{repo}",
     "approve": "gh pr review {number} --repo {owner}/{repo} --approve"
   }

package/dist/bin/prq.js

@@ -6424,7 +6424,7 @@ function getAction(name, config) {
 function listActions(config) {
   return { ...DEFAULT_ACTIONS, ...config.actions };
 }
-function buildContext(pr) {
+function buildContext(pr, category = "") {
   const days = Math.floor((Date.now() - new Date(pr.updatedAt || Date.now()).getTime()) / 86400000);
   return {
     url: pr.url,
@@ -6434,7 +6434,8 @@ function buildContext(pr) {
     fullRepo: `${pr.owner}/${pr.repo}`,
     title: pr.title,
     author: pr.author,
-    days
+    days,
+    category
   };
 }
 function interpolate(template, context) {
@@ -6797,14 +6798,34 @@ function render(state) {
   process.stdout.write(lines.join(`
 `));
 }
-async function runAction(actionName, template, pr, state) {
-  const cmd = interpolate(template, buildContext(toResolvedPR(pr)));
-  state.message = source_default.dim(`running ${actionName} on ${pr.repo}#${pr.number}...`);
+function suspend() {
+  process.stdin.setRawMode(false);
+  process.stdin.pause();
+  process.stdin.removeAllListeners("data");
+  process.stdout.write("\x1B[?25h\x1B[2J\x1B[H");
+}
+function resume(state, onData) {
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+  process.stdin.setEncoding("utf8");
+  process.stdout.write("\x1B[?25l");
+  process.stdin.on("data", onData);
   render(state);
+}
+async function runAction(actionName, template, pr, state, onData) {
+  const context = buildContext(toResolvedPR(pr), pr.category);
+  const cmd = interpolate(template, context);
+  suspend();
+  process.stdout.write(source_default.dim(`
+  running ${actionName} on ${pr.repo}#${pr.number}...
+
+`));
   try {
     await executeCommand(cmd);
+    resume(state, onData);
     return source_default.green(`${actionName}: ${pr.repo}#${pr.number}`);
   } catch {
+    resume(state, onData);
     return source_default.red(`${actionName} failed`);
   }
 }
@@ -6828,33 +6849,22 @@ async function interactiveMode(result, config) {
 `);
     return;
   }
-  process.stdin.setRawMode(true);
-  process.stdin.resume();
-  process.stdin.setEncoding("utf8");
-  process.stdout.write("\x1B[?25l");
-  render(state);
   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 onData = async (key) => {
       const pr = result.prs[state.selectedIndex];
       if (state.actionMenu) {
         if (key === "q" || key === "\x1B" || key === "a") {
           state.actionMenu = null;
           state.message = "";
         } else if (key === "\x03") {
-          cleanup();
+          suspend();
           resolve();
           return;
         } else {
           const idx = parseInt(key, 10);
           if (idx >= 1 && idx <= state.actionMenu.length) {
             const action = state.actionMenu[idx - 1];
-            state.message = await runAction(action.name, action.template, pr, state);
+            state.message = await runAction(action.name, action.template, pr, state, onData);
             state.actionMenu = null;
           }
         }
@@ -6864,7 +6874,7 @@ async function interactiveMode(result, config) {
       switch (key) {
         case "q":
         case "\x03":
-          cleanup();
+          suspend();
           resolve();
           return;
         case "\x1B[A":
@@ -6878,21 +6888,21 @@ async function interactiveMode(result, config) {
         case "o": {
           const template = allActions.open;
           if (template) {
-            state.message = await runAction("open", template, pr, state);
+            state.message = await runAction("open", template, pr, state, onData);
           }
           break;
         }
         case "r": {
           const template = allActions.review;
           if (template) {
-            state.message = await runAction("review", template, pr, state);
+            state.message = await runAction("review", template, pr, state, onData);
           }
           break;
         }
         case "n": {
           const template = allActions.nudge;
           if (template) {
-            state.message = await runAction("nudge", template, pr, state);
+            state.message = await runAction("nudge", template, pr, state, onData);
           }
           break;
         }
@@ -6920,7 +6930,8 @@ async function interactiveMode(result, config) {
           break;
       }
       render(state);
-    });
+    };
+    resume(state, onData);
   });
 }
 

package/package.json

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