prq-cli 0.8.0 → 0.10.0

package/README.md

@@ -4,7 +4,7 @@
 
 PR Queue — see what code reviews need your attention.
 
-A CLI tool that shows you a categorized view of PRs that need action — then lets you act on them with whatever tools you already use. PRQ is the queue. You bring the workflow.
+Four categories. What needs re-review, what's requested, what's stale, what's waiting on others. `prq` is the queue. You bring the workflow.
 
 ## Install
 
@@ -40,6 +40,8 @@ Shows PRs needing your attention in four categories:
 - **○ Stale** — no activity for N days
 - **◇ Your PRs Waiting** — waiting on someone else
 
+PRs you mark as started appear in a separate **▸ In Progress** group at the top.
+
 ```bash
 prq                                        # interactive mode (default)
 prq status --repos org/repo1 org/repo2     # specific repos
@@ -58,6 +60,7 @@ Interactive mode is the default when running in a terminal. Navigate your queue
 | r | Review — open files changed |
 | o | Open — open PR in browser |
 | n | Nudge — post a comment |
+| s | Start/Stop — mark as in progress |
 | c | Copy URL to clipboard |
 | a | Actions — open menu with all actions |
 | q | Quit |
@@ -93,9 +96,9 @@ prq skill            # install in current project
 prq skill --global   # install globally
 ```
 
-## Pluggable Actions
+## Custom Actions
 
-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`.
+`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.
 
@@ -163,9 +166,9 @@ With no config, `prq review` opens the files changed tab and `prq open` opens th
 | `{days}` | `5` |
 | `{category}` | `needs-re-review` |
 
-## Agent & Automation
+## Scripting
 
-PRQ is fully scriptable with `--json` output and `--yes` flags:
+`prq` is fully scriptable with `--json` output and `--yes` flags:
 
 ```bash
 # Agent reads the queue
@@ -181,7 +184,7 @@ prq status --json | claude -p "Review needs-re-review PRs older than 7 days"
 
 ### Claude Code Skill
 
-Install the `/prq` skill to use PRQ inside Claude Code sessions:
+Install the `/prq` skill to use `prq` inside Claude Code sessions:
 
 ```bash
 prq skill --global

package/dist/bin/prq.js

@@ -2081,8 +2081,8 @@ var require_commander = __commonJS((exports) => {
 });
 
 // src/cli.ts
-import fs3 from "node:fs";
-import path3 from "node:path";
+import fs4 from "node:fs";
+import path4 from "node:path";
 import { fileURLToPath } from "node:url";
 
 // ../../node_modules/.bun/commander@13.1.0/node_modules/commander/esm.mjs
@@ -6482,98 +6482,62 @@ Available actions: ${available}`);
 // 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".
+description: PR review queue manager. Use when the user wants to check their PR review queue, review PRs, nudge stale PRs, open PRs, or manage code review workflow. Triggers on mentions of "review queue", "PRs waiting", "stale PRs", "what needs review", "open PR", "nudge", 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.
+# PRQ CLI
 
-## Step 1: Get the queue
+\`prq\` is a CLI tool for managing code review queues. It's installed on this machine.
 
-Run this command to get the user's current review queue:
+## Commands
 
 \`\`\`bash
+# Show the review queue (JSON for parsing)
 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
+# Open a PR in the browser
+prq open <number>
+prq open <owner/repo#number>
 
-## Step 2: Present the queue
+# Open files changed tab for review
+prq review <number>
 
-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")
+# Post a nudge comment on a stale PR
+prq nudge <number> --yes
+prq nudge <number> --message "Custom message" --yes
 
-Then ask what the user wants to do.
+# Run any configured action
+prq run <action> <number>
+\`\`\`
 
-## Step 3: Act on PRs
+## JSON output
 
-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:
+\`prq status --json\` returns:
 
 \`\`\`json
 {
-  "actions": {
-    "review": "/review {url}",
-    "nudge": "shell:prq nudge {number} --yes"
-  }
+  "user": "caio-pizzol",
+  "prs": [
+    {
+      "category": "needs-re-review",
+      "repo": "org/repo",
+      "number": 2439,
+      "title": "fix: something",
+      "author": "alice",
+      "url": "https://github.com/org/repo/pull/2439",
+      "detail": "New commits since your review 1d ago"
+    }
+  ]
 }
 \`\`\`
 
-### 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}\`
+Categories: \`needs-re-review\`, \`requested\`, \`stale\`, \`waiting-on-others\`.
 
-## Step 4: Batch operations
+## Usage
 
-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
+- When the user asks about their review queue, run \`prq status --json\` and present the results grouped by category.
+- When the user asks to open, review, or nudge a PR, use the corresponding \`prq\` command.
+- For batch operations ("nudge all stale PRs"), filter the JSON output and confirm with the user before acting.
 `;
 function skillCommand(global) {
   if (global) {
@@ -6700,8 +6664,59 @@ function categorize(reviewedPRs, requestedPRs, authoredPRs, staleDays) {
   return results;
 }
 
+// src/state.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+var STATE_DIR = path2.join(process.env.HOME ?? process.env.USERPROFILE ?? "", ".config", "prq");
+var STATE_PATH = path2.join(STATE_DIR, "in-progress.json");
+function prKey(pr) {
+  return `${pr.repo}#${pr.number}`;
+}
+function loadInProgress() {
+  try {
+    const data = JSON.parse(fs2.readFileSync(STATE_PATH, "utf8"));
+    return new Set(Array.isArray(data) ? data : []);
+  } catch {
+    return new Set;
+  }
+}
+function save(keys) {
+  fs2.mkdirSync(STATE_DIR, { recursive: true });
+  fs2.writeFileSync(STATE_PATH, JSON.stringify(Array.from(keys), null, 2));
+}
+function toggleInProgress(pr) {
+  const keys = loadInProgress();
+  const k = prKey(pr);
+  if (keys.has(k)) {
+    keys.delete(k);
+    save(keys);
+    return false;
+  }
+  keys.add(k);
+  save(keys);
+  return true;
+}
+function applyInProgress(prs) {
+  const keys = loadInProgress();
+  if (keys.size === 0)
+    return prs;
+  const activeKeys = new Set(prs.map(prKey));
+  const staleKeys = Array.from(keys).filter((k) => !activeKeys.has(k));
+  if (staleKeys.length > 0) {
+    for (const k of staleKeys)
+      keys.delete(k);
+    save(keys);
+  }
+  return prs.map((pr) => keys.has(prKey(pr)) ? { ...pr, category: "in-progress" } : pr);
+}
+
 // src/interactive.ts
 var CATEGORY_CONFIG = {
+  "in-progress": {
+    icon: "▸",
+    label: "In Progress",
+    color: source_default.cyan
+  },
   "needs-re-review": {
     icon: "◆",
     label: "Needs Re-review",
@@ -6716,6 +6731,7 @@ var CATEGORY_CONFIG = {
   }
 };
 var CATEGORY_ORDER = [
+  "in-progress",
   "needs-re-review",
   "requested",
   "stale",
@@ -6788,8 +6804,10 @@ function render(state) {
     lines.push("");
     lines.push(` ${source_default.dim("1-9")} run action  ${source_default.white("q")} back`);
   } else {
+    const pr = result.prs[selectedIndex];
+    const sLabel = pr?.category === "in-progress" ? "stop" : "start";
     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("a")} actions  ${source_default.white("q")} quit`);
+    lines.push(` ${source_default.dim("↑↓")} navigate  ${source_default.white("r")} review  ${source_default.white("o")} open  ${source_default.white("n")} nudge  ${source_default.white("s")} ${sLabel}  ${source_default.white("c")} copy url  ${source_default.white("a")} actions  ${source_default.white("q")} quit`);
   }
   if (message) {
     lines.push("");
@@ -6829,7 +6847,7 @@ async function runAction(actionName, template, pr, state, onData) {
     return source_default.red(`${actionName} failed`);
   }
 }
-async function interactiveMode(result, config) {
+async function interactiveMode(result, sourcePrs, config) {
   if (result.prs.length === 0) {
     console.log(source_default.green(`
   All clear! No PRs need your attention.
@@ -6840,6 +6858,7 @@ async function interactiveMode(result, config) {
   const allActions = listActions(config);
   const state = {
     result,
+    sourcePrs,
     selectedIndex: 0,
     message: "",
     actionMenu: null
@@ -6917,6 +6936,19 @@ async function interactiveMode(result, config) {
           }
           break;
         }
+        case "s": {
+          const started = toggleInProgress(pr);
+          state.result = {
+            ...state.result,
+            prs: applyInProgress(state.sourcePrs)
+          };
+          const newTotal = state.result.prs.length;
+          if (state.selectedIndex >= newTotal) {
+            state.selectedIndex = Math.max(0, newTotal - 1);
+          }
+          state.message = started ? source_default.cyan(`started: ${pr.repo}#${pr.number}`) : source_default.dim(`unmarked: ${pr.repo}#${pr.number}`);
+          break;
+        }
         case "a": {
           const entries = Object.entries(allActions);
           state.actionMenu = entries.map(([name, template]) => ({
@@ -6937,6 +6969,11 @@ async function interactiveMode(result, config) {
 
 // src/output.ts
 var CATEGORY_CONFIG2 = {
+  "in-progress": {
+    icon: "▸",
+    label: "In Progress",
+    color: source_default.cyan
+  },
   "needs-re-review": {
     icon: "◆",
     label: "Needs Re-review",
@@ -6951,6 +6988,7 @@ var CATEGORY_CONFIG2 = {
   }
 };
 var CATEGORY_ORDER2 = [
+  "in-progress",
   "needs-re-review",
   "requested",
   "stale",
@@ -7020,7 +7058,8 @@ async function statusCommand(config, json, interactive) {
   process.stderr.write(`Found ${reviewedRaw.length} reviewed, ${requestedPRs.length} requested, ${authoredPRs.length} authored
 `);
   const reviewedPRs = await enrichAllWithReviews(reviewedRaw, user);
-  const prs = categorize(reviewedPRs, requestedPRs, authoredPRs, config.staleDays);
+  const categorized = categorize(reviewedPRs, requestedPRs, authoredPRs, config.staleDays);
+  const prs = applyInProgress(categorized);
   const result = {
     user,
     timestamp: new Date().toISOString(),
@@ -7030,15 +7069,15 @@ async function statusCommand(config, json, interactive) {
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
   } else if (interactive && process.stdin.isTTY) {
-    await interactiveMode(result, config);
+    await interactiveMode(result, categorized, config);
   } else {
     process.stdout.write(formatStatus(result));
   }
 }
 
 // src/config.ts
-import fs2 from "node:fs";
-import path2 from "node:path";
+import fs3 from "node:fs";
+import path3 from "node:path";
 
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/external.js
 var exports_external = {};
@@ -7515,8 +7554,8 @@ function getErrorMap() {
 }
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path2, errorMaps, issueData } = params;
-  const fullPath = [...path2, ...issueData.path || []];
+  const { data, path: path3, errorMaps, issueData } = params;
+  const fullPath = [...path3, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7628,11 +7667,11 @@ var errorUtil;
 
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/types.js
 class ParseInputLazyPath {
-  constructor(parent, value, path2, key) {
+  constructor(parent, value, path3, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path2;
+    this._path = path3;
     this._key = key;
   }
   get path() {
@@ -11022,14 +11061,14 @@ var configSchema = exports_external.object({
 });
 function loadConfig(cliOverrides) {
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  const globalPath = path2.join(home, ".config", "prq", "config.json");
-  const localPath = path2.join(process.cwd(), ".prqrc.json");
+  const globalPath = path3.join(home, ".config", "prq", "config.json");
+  const localPath = path3.join(process.cwd(), ".prqrc.json");
   let config = {};
-  if (fs2.existsSync(globalPath)) {
-    config = JSON.parse(fs2.readFileSync(globalPath, "utf8"));
+  if (fs3.existsSync(globalPath)) {
+    config = JSON.parse(fs3.readFileSync(globalPath, "utf8"));
   }
-  if (fs2.existsSync(localPath)) {
-    config = { ...config, ...JSON.parse(fs2.readFileSync(localPath, "utf8")) };
+  if (fs3.existsSync(localPath)) {
+    config = { ...config, ...JSON.parse(fs3.readFileSync(localPath, "utf8")) };
   }
   for (const [key, value] of Object.entries(cliOverrides)) {
     if (value !== undefined) {
@@ -11041,11 +11080,11 @@ function loadConfig(cliOverrides) {
 
 // src/cli.ts
 function getVersion() {
-  const __dirname2 = path3.dirname(fileURLToPath(import.meta.url));
+  const __dirname2 = path4.dirname(fileURLToPath(import.meta.url));
   for (const rel of ["../../package.json", "../package.json"]) {
-    const p = path3.resolve(__dirname2, rel);
-    if (fs3.existsSync(p)) {
-      return JSON.parse(fs3.readFileSync(p, "utf8")).version;
+    const p = path4.resolve(__dirname2, rel);
+    if (fs4.existsSync(p)) {
+      return JSON.parse(fs4.readFileSync(p, "utf8")).version;
     }
   }
   return "0.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "prq-cli",
-	"version": "0.8.0",
+	"version": "0.10.0",
 	"description": "PR Queue — see what code reviews need your attention",
 	"type": "module",
 	"bin": {
@@ -37,6 +37,6 @@
 		"type": "git",
 		"url": "git+https://github.com/caiopizzol/prq.git"
 	},
-	"homepage": "https://github.com/caiopizzol/prq",
+	"homepage": "https://prq.sh",
 	"bugs": "https://github.com/caiopizzol/prq/issues"
 }