chrome-relay 0.3.3 → 0.4.0

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 import { writeFileSync } from "fs";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.3.3" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.4.0" : "0.0.0-dev";
 
 // src/install/install.ts
 import os from "os";
@@ -154,7 +154,7 @@ async function callTool(name, args) {
 // src/program.ts
 function buildProgram() {
   const program = new Command();
-  program.name("chrome-relay").description("Connect your local Chrome browser to coding agents through a local bridge.").version(CHROME_RELAY_VERSION).showHelpAfterError().option("--group <name>", "target the active tab of a named group window (works at top level too)").enablePositionalOptions().addHelpText(
+  program.name("chrome-relay").description("Connect your local Chrome browser to coding agents through a local bridge.").version(CHROME_RELAY_VERSION).showHelpAfterError().option("--workspace <name>", "target the active tab in a named workspace window (works at top level too)").option("--group <name>", "target the active tab in a named tab-group (works at top level too)").enablePositionalOptions().addHelpText(
     "after",
     `
 
@@ -197,12 +197,15 @@ Notes:
     }
   }
   function tabOpt(cmd) {
-    return cmd.option("-t, --tab <id>", "target tab ID", (v) => Number(v)).option("--group <name>", "target the active tab of a named group window (see `chrome-relay group`)");
+    return cmd.option("-t, --tab <id>", "target tab ID", (v) => Number(v)).option("--workspace <name>", "target the active tab in a named workspace window (see `chrome-relay workspace`)").option("--group <name>", "target the active tab in a named tab-group (see `chrome-relay group`)");
   }
   function baseArgs(opts) {
     const args = {};
     if (opts.tab !== void 0) args.tabId = opts.tab;
-    const effectiveGroup = opts.group ?? program.opts().group;
+    const parentOpts = program.opts();
+    const effectiveWorkspace = opts.workspace ?? parentOpts.workspace;
+    const effectiveGroup = opts.group ?? parentOpts.group;
+    if (effectiveWorkspace) args.workspaceName = effectiveWorkspace;
     if (effectiveGroup) args.groupName = effectiveGroup;
     return args;
   }
@@ -468,35 +471,79 @@ Notes:
     args.node = opts.node;
     await run("chrome_click_ax", args);
   });
-  const group = program.command("group").description("Manage named Chrome windows so multiple agents can drive separate windows.").addHelpText(
+  const workspace = program.command("workspace").description("Manage named Chrome windows so multiple agents can drive separate windows.").addHelpText(
     "after",
     `
 
 Examples:
-  chrome-relay group create bidsmith-h01 --url https://reddit.com
-  chrome-relay group list
-  chrome-relay --group bidsmith-h01 navigate https://news.ycombinator.com
-  chrome-relay --group bidsmith-h01 screenshot -o evidence.png
-  chrome-relay group close bidsmith-h01
+  chrome-relay workspace create bidsmith-h01 --url https://reddit.com
+  chrome-relay workspace list
+  chrome-relay --workspace bidsmith-h01 navigate https://news.ycombinator.com
+  chrome-relay --workspace bidsmith-h01 screenshot -o evidence.png
+  chrome-relay workspace close bidsmith-h01
 
 Notes:
-  Hard lifecycle: if you manually close the group's window, the next
-  --group operation fails loudly until you run \`group close\` + \`group create\` again.
-  If you pass both --tab and --group on the same command, --tab wins.
+  Hard lifecycle: if you manually close the workspace's window, the next
+  --workspace operation fails loudly until you run \`workspace close\` +
+  \`workspace create\` again.
+  Precedence on a single command: --tab > --group > --workspace.
 `
   );
-  group.command("create <name>").description("Open a new Chrome window and bind it to <name>.").option("--url <url>", "initial URL (default about:blank)").option("--label <label>", "human-readable description shown in popup/list").action(async (name, opts) => {
+  workspace.command("create <name>").description("Open a new Chrome window and bind it to <name>.").option("--url <url>", "initial URL (default about:blank)").option("--label <label>", "human-readable description shown in popup/list").action(async (name, opts) => {
     const args = { action: "create", name };
     if (opts.url) args.url = opts.url;
     if (opts.label) args.label = opts.label;
+    await run("chrome_workspace", args);
+  });
+  workspace.command("list").description("List all known workspaces + whether their window is still alive.").action(async () => {
+    await run("chrome_workspace", { action: "list" });
+  });
+  workspace.command("close <name>").description("Close the workspace's window (if alive) and remove the binding.").action(async (name) => {
+    await run("chrome_workspace", { action: "close", name });
+  });
+  const group = program.command("group").description("Manage Chrome tab-groups (the colored, collapsible folders inside one window).").addHelpText(
+    "after",
+    `
+
+Examples:
+  chrome-relay group create research --tabs 123,456,789 --color cyan
+  chrome-relay group list
+  chrome-relay group add research --tabs 1011
+  chrome-relay group remove --tabs 456
+  chrome-relay --group research navigate https://news.ycombinator.com
+  chrome-relay group close research
+
+Notes:
+  Tab-groups live inside ONE Chrome window. To open in a specific window,
+  pass --workspace W on \`group create\` (we'll route the underlying
+  chrome.tabs.group call there).
+  \`--group X navigate --new\` opens the new tab into the group's window AND
+  drops it inside the group.
+  Auto-pruned when the group's last tab is ungrouped or its window closes.
+  Colors: grey, blue, red, yellow, green, pink, purple, cyan, orange.
+`
+  );
+  group.command("create <name>").description("Group existing tabs into a new tab-group bound to <name>.").requiredOption("--tabs <ids>", "comma-separated tab IDs to group, e.g. 123,456,789").option("--color <color>", "grey | blue | red | yellow | green | pink | purple | cyan | orange").option("--collapsed", "create the group in its collapsed state").action(async (name, opts) => {
+    const args = { action: "create", name };
+    args.tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
+    if (opts.color) args.color = opts.color;
+    if (opts.collapsed) args.collapsed = true;
     await run("chrome_group", args);
   });
-  group.command("list").description("List all known groups + whether their window is still alive.").action(async () => {
+  group.command("list").description("List all known tab-groups + their window/color/tabCount.").action(async () => {
     await run("chrome_group", { action: "list" });
   });
-  group.command("close <name>").description("Close the group's window (if alive) and remove the binding.").action(async (name) => {
+  group.command("close <name>").description("Ungroup the tabs in <name> and remove the binding.").action(async (name) => {
     await run("chrome_group", { action: "close", name });
   });
+  group.command("add <name>").description("Add existing tabs to an existing tab-group.").requiredOption("--tabs <ids>", "comma-separated tab IDs to add").action(async (name, opts) => {
+    const tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
+    await run("chrome_group", { action: "add", name, tabIds });
+  });
+  group.command("remove").description("Ungroup specific tabs (they remain open, just outside any tab-group).").requiredOption("--tabs <ids>", "comma-separated tab IDs to ungroup").action(async (opts) => {
+    const tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
+    await run("chrome_group", { action: "remove", tabIds });
+  });
   function netFilterOpts(cmd) {
     return cmd.option("--filter <substr>", "url substring filter").option("--status <bucket>", "ok | redirect | client_error | server_error | failed").option("--method <verb>", "exact method, e.g. POST").option("--limit <n>", "cap response length", (v) => Number(v));
   }

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.3.3" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.4.0" : "0.0.0-dev";
 export {
   CHROME_RELAY_VERSION
 };

package/package.json

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