@react-grab/cli 0.1.44-dev.f5093a4 → 0.1.44-dev.f610e2f

package/dist/cli.cjs

@@ -519,7 +519,7 @@ const removeSkill = async ({ cwd = process.cwd(), global = false } = {}) => {
 };
 //#endregion
 //#region src/commands/add.ts
-const VERSION$5 = "0.1.44-dev.f5093a4";
+const VERSION$5 = "0.1.44-dev.f610e2f";
 const add = new commander.Command().name("add").alias("install").description("install the React Grab skill for your agent").option("-y, --yes", "skip confirmation prompts", false).option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).option("-g, --global", "install the skill globally instead of in the project", false).action(async (opts) => {
 	console.log(`${picocolors.default.magenta("✿")} ${picocolors.default.bold("React Grab")} ${picocolors.default.gray(VERSION$5)}`);
 	console.log();
@@ -1138,7 +1138,7 @@ const formatActivationKeyDisplay = (activationKey) => {
 };
 //#endregion
 //#region src/commands/configure.ts
-const VERSION$4 = "0.1.44-dev.f5093a4";
+const VERSION$4 = "0.1.44-dev.f610e2f";
 const isMac = process.platform === "darwin";
 const META_LABEL = isMac ? "Cmd" : "Win";
 const ALT_LABEL = isMac ? "Option" : "Alt";
@@ -1763,7 +1763,7 @@ const isTelemetryEnabled = () => {
 };
 //#endregion
 //#region src/commands/init.ts
-const VERSION$3 = "0.1.44-dev.f5093a4";
+const VERSION$3 = "0.1.44-dev.f610e2f";
 const REPORT_URL = "https://react-grab.com/api/report-cli";
 const DOCS_URL = "https://github.com/aidenybai/react-grab";
 const reportToCli = (type, config, error) => {
@@ -2713,7 +2713,7 @@ const pull = new commander.Command().name("pull").description("start the watcher
 });
 //#endregion
 //#region src/commands/remove.ts
-const VERSION$2 = "0.1.44-dev.f5093a4";
+const VERSION$2 = "0.1.44-dev.f610e2f";
 const remove = new commander.Command().name("remove").description("uninstall the React Grab skill from your agent").option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).option("-g, --global", "remove the globally-installed skill instead of the project's", false).action(async (opts) => {
 	console.log(`${picocolors.default.magenta("✿")} ${picocolors.default.bold("React Grab")} ${picocolors.default.gray(VERSION$2)}`);
 	console.log();
@@ -2741,7 +2741,7 @@ const stop = new commander.Command().name("stop").description("stop the React Gr
 });
 //#endregion
 //#region src/commands/upgrade.ts
-const VERSION$1 = "0.1.44-dev.f5093a4";
+const VERSION$1 = "0.1.44-dev.f610e2f";
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/react-grab/latest";
 const fetchLatestVersion = async () => {
 	try {
@@ -2853,7 +2853,7 @@ const watch = new commander.Command().name("watch").description("run the React G
 });
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.1.44-dev.f5093a4";
+const VERSION = "0.1.44-dev.f610e2f";
 const VERSION_API_URL = "https://www.react-grab.com/api/version";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));

package/dist/cli.js

@@ -491,7 +491,7 @@ const removeSkill = async ({ cwd = process.cwd(), global = false } = {}) => {
 };
 //#endregion
 //#region src/commands/add.ts
-const VERSION$5 = "0.1.44-dev.f5093a4";
+const VERSION$5 = "0.1.44-dev.f610e2f";
 const add$1 = new Command().name("add").alias("install").description("install the React Grab skill for your agent").option("-y, --yes", "skip confirmation prompts", false).option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).option("-g, --global", "install the skill globally instead of in the project", false).action(async (opts) => {
 	console.log(`${pc.magenta("✿")} ${pc.bold("React Grab")} ${pc.gray(VERSION$5)}`);
 	console.log();
@@ -1110,7 +1110,7 @@ const formatActivationKeyDisplay = (activationKey) => {
 };
 //#endregion
 //#region src/commands/configure.ts
-const VERSION$4 = "0.1.44-dev.f5093a4";
+const VERSION$4 = "0.1.44-dev.f610e2f";
 const isMac = process.platform === "darwin";
 const META_LABEL = isMac ? "Cmd" : "Win";
 const ALT_LABEL = isMac ? "Option" : "Alt";
@@ -1735,7 +1735,7 @@ const isTelemetryEnabled = () => {
 };
 //#endregion
 //#region src/commands/init.ts
-const VERSION$3 = "0.1.44-dev.f5093a4";
+const VERSION$3 = "0.1.44-dev.f610e2f";
 const REPORT_URL = "https://react-grab.com/api/report-cli";
 const DOCS_URL = "https://github.com/aidenybai/react-grab";
 const reportToCli = (type, config, error) => {
@@ -2685,7 +2685,7 @@ const pull = new Command().name("pull").description("start the watcher if needed
 });
 //#endregion
 //#region src/commands/remove.ts
-const VERSION$2 = "0.1.44-dev.f5093a4";
+const VERSION$2 = "0.1.44-dev.f610e2f";
 const remove = new Command().name("remove").description("uninstall the React Grab skill from your agent").option("-c, --cwd <cwd>", "working directory (defaults to current directory)", process.cwd()).option("-g, --global", "remove the globally-installed skill instead of the project's", false).action(async (opts) => {
 	console.log(`${pc.magenta("✿")} ${pc.bold("React Grab")} ${pc.gray(VERSION$2)}`);
 	console.log();
@@ -2713,7 +2713,7 @@ const stop = new Command().name("stop").description("stop the React Grab watcher
 });
 //#endregion
 //#region src/commands/upgrade.ts
-const VERSION$1 = "0.1.44-dev.f5093a4";
+const VERSION$1 = "0.1.44-dev.f610e2f";
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/react-grab/latest";
 const fetchLatestVersion = async () => {
 	try {
@@ -2825,7 +2825,7 @@ const watch = new Command().name("watch").description("run the React Grab captur
 });
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.1.44-dev.f5093a4";
+const VERSION = "0.1.44-dev.f610e2f";
 const VERSION_API_URL = "https://www.react-grab.com/api/version";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-grab/cli",
-  "version": "0.1.44-dev.f5093a4",
+  "version": "0.1.44-dev.f610e2f",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/aidenybai/react-grab.git"

package/skills/react-grab/SKILL.md

@@ -11,9 +11,9 @@ description: >-
 # React Grab
 
 The user selects UI elements in their browser and copies them with React Grab.
-`npx grab pull` waits for new grabs and prints each as one line of JSON (usually
-one, sometimes a few if several were copied), starting the background watcher
-automatically the first time. Run it in a loop.
+`npx react-grab@latest pull` waits for new grabs and prints each as one line of
+JSON (usually one, sometimes a few if several were copied), starting the
+background watcher automatically the first time. Run it in a loop.
 
 ## The loop
 
@@ -22,17 +22,40 @@ Repeat until the user says stop:
 1. Wait for the next grab:
 
 ```bash
-npx grab pull
+npx react-grab@latest pull --max-age 0
 ```
 
 It blocks until the user grabs something, then prints the new grab(s) — one JSON
-object per line. Act on every line. If your shell cancels the command before a
-grab arrives, just run it again — nothing is lost; the watcher keeps capturing in
-the background and `pull` resumes where it left off.
+object per line. `--max-age 0` is important: it delivers every grab regardless of
+age, so a comment the user added while you were busy on the previous task isn't
+silently dropped (the default skips grabs older than ~5 min as stale). Act on
+every line. If your shell cancels the command before a grab arrives, just run it
+again — nothing is lost; the watcher keeps capturing in the background and `pull`
+resumes where it left off.
 
 2. Act on the grab (below).
 3. Go back to step 1.
 
+## A new grab while you're working wins
+
+The watcher never stops capturing — including while you're mid-task. A grab the
+user makes before you finish is them redirecting you, so it supersedes whatever
+you're doing. Don't make them wait for the old task to finish.
+
+While acting on a grab:
+
+- Run anything slow (dev servers, builds, installs, test runs) as a background
+  process, never a blocking foreground call, so you stay free to notice new grabs.
+- Between steps, peek without blocking:
+
+```bash
+npx react-grab@latest pull --max-age 0 --wait 0
+```
+
+  Empty output means nothing new — keep going. If it prints a grab, the user has
+  moved on: stop the current task, cancel any background processes you started for
+  it, and act on the newest grab instead.
+
 ## Acting on a grab
 
 Each grab JSON has `content` (the element's source references) and, in prompt
@@ -50,12 +73,10 @@ mode, `prompt` (the user's typed instruction):
 When the user says stop, run this and don't pull again:
 
 ```bash
-npx grab stop
+npx react-grab@latest stop
 ```
 
 ## Notes
 
 - The watcher reads the clipboard on the machine it runs on — run it on the same
   machine as the browser, not over SSH or in a remote container.
-- Grabs older than ~5 minutes are skipped as stale; use `npx grab pull --max-age 0`
-  to deliver every grab regardless of age.