chrome-relay 0.2.0 → 0.2.2

package/README.md

@@ -10,7 +10,7 @@ chrome-relay install
 chrome-relay doctor
 ```
 
-Then load the Browser Relay extension in Chrome.
+Then load the Chrome Relay extension in Chrome.
 
 ## Usage
 
@@ -18,10 +18,11 @@ Then load the Browser Relay extension in Chrome.
 chrome-relay tabs
 chrome-relay read -i
 chrome-relay navigate "https://example.com" --new
+chrome-relay navigate --tab <tabId> "https://example.com"
 chrome-relay click "<selector>"
 chrome-relay fill "<selector>" "value"
 chrome-relay keys "Enter"
-chrome-relay screenshot -o page.png
+chrome-relay screenshot --tab <tabId> -o page.png
 ```
 
 ## How it works
@@ -32,7 +33,7 @@ chrome-relay screenshot -o page.png
 chrome-relay CLI
 -> local bridge on your machine
 -> Chrome native host
--> Browser Relay extension
+-> Chrome Relay extension
 -> Chrome APIs
 ```
 

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 import { writeFileSync } from "fs";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = "0.2.0";
+var CHROME_RELAY_VERSION = "0.2.2";
 
 // src/install/install.ts
 import os from "os";
@@ -122,7 +122,23 @@ async function callTool(name, args) {
 
 // src/cli.ts
 var program = new Command();
-program.name("chrome-relay").description("Connect your local Chrome browser to coding agents through a local bridge.").version(CHROME_RELAY_VERSION);
+program.name("chrome-relay").description("Connect your local Chrome browser to coding agents through a local bridge.").version(CHROME_RELAY_VERSION).showHelpAfterError().addHelpText(
+  "after",
+  `
+
+Common agent flow:
+  chrome-relay tabs
+  chrome-relay navigate --tab <tabId> "https://example.com"
+  chrome-relay read --tab <tabId> -i
+  chrome-relay click --tab <tabId> "<selector>"
+  chrome-relay fill --tab <tabId> "<selector>" "value"
+  chrome-relay screenshot --tab <tabId> -o evidence.png
+
+Notes:
+  navigate takes a URL. Use --tab to target an existing tab.
+  screenshot --tab <tabId> auto-activates that tab first because Chrome only screenshots visible tabs.
+`
+);
 program.command("install").description("Install and register the local Chrome Relay host.").action(async () => {
   await runInstall();
 });
@@ -148,14 +164,29 @@ async function run(name, args) {
 function tabOpt(cmd) {
   return cmd.option("-t, --tab <id>", "target tab ID", (v) => Number(v));
 }
-tabOpt(
-  program.command("tabs").description("List open Chrome windows and tabs.")
-).action(async () => {
+program.command("tabs").description("List open Chrome windows and tabs.").action(async () => {
   await run("get_windows_and_tabs", {});
 });
 tabOpt(
-  program.command("navigate <url>").description("Navigate a tab to a URL.").option("--new", "open in a new tab").option("--inactive", "do not activate the tab")
+  program.command("navigate <url>").description("Navigate a tab to a URL. Use --tab <id> to target an existing tab.").option("--new", "open in a new tab").option("--inactive", "do not activate the tab").addHelpText(
+    "after",
+    `
+
+Examples:
+  chrome-relay navigate "https://example.com"
+  chrome-relay navigate --tab 123456789 "https://example.com"
+  chrome-relay navigate "https://example.com" --new --inactive
+`
+  )
 ).action(async (url, opts) => {
+  if (/^\d+$/.test(url)) {
+    process.stderr.write(
+      `navigate expects a URL, but "${url}" looks like a tab ID.
+Use "chrome-relay switch ${url}" to activate that tab, or "chrome-relay navigate --tab ${url} https://example.com" to navigate it.
+`
+    );
+    process.exit(1);
+  }
   const args = { url };
   if (opts.tab !== void 0) args.tabId = opts.tab;
   if (opts.new) args.newTab = true;
@@ -163,7 +194,17 @@ tabOpt(
   await run("chrome_navigate", args);
 });
 tabOpt(
-  program.command("screenshot").description("Capture a screenshot of the current page.").option("--full", "capture full page").option("-o, --out <path>", "save image to path (base64 PNG decoded)")
+  program.command("screenshot").description("Capture a screenshot. With --tab, the tab is auto-activated first.").option("--full", "capture full page").option("-o, --out <path>", "save image to path (base64 PNG decoded)").addHelpText(
+    "after",
+    `
+
+Examples:
+  chrome-relay screenshot -o active-tab.png
+  chrome-relay screenshot --tab 123456789 -o evidence.png
+
+Chrome can only capture visible tabs, so --tab will focus/activate the tab before capturing.
+`
+  )
 ).action(async (opts) => {
   const args = {};
   if (opts.tab !== void 0) args.tabId = opts.tab;

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-declare const CHROME_RELAY_VERSION = "0.2.0";
+declare const CHROME_RELAY_VERSION = "0.2.2";
 
 export { CHROME_RELAY_VERSION };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var CHROME_RELAY_VERSION = "0.2.0";
+var CHROME_RELAY_VERSION = "0.2.2";
 export {
   CHROME_RELAY_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-relay",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",