@flrande/browserctl 0.1.0

package/apps/browserd/src/main.ts

@@ -0,0 +1,7 @@
+import { bootstrapBrowserd } from "./bootstrap";
+
+export function main() {
+  return bootstrapBrowserd();
+}
+
+void main();

package/bin/browserctl.cjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+const { spawn } = require("node:child_process");
+const { resolve } = require("node:path");
+
+const repoRoot = resolve(__dirname, "..");
+const entry = resolve(repoRoot, "apps/browserctl/src/main.ts");
+
+const child = spawn(process.execPath, ["--import", "tsx", entry, ...process.argv.slice(2)], {
+  cwd: repoRoot,
+  env: process.env,
+  stdio: "inherit"
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 1);
+});

package/bin/browserd.cjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+const { spawn } = require("node:child_process");
+const { resolve } = require("node:path");
+
+const repoRoot = resolve(__dirname, "..");
+const entry = resolve(repoRoot, "apps/browserd/src/main.ts");
+
+const child = spawn(process.execPath, ["--import", "tsx", entry, ...process.argv.slice(2)], {
+  cwd: repoRoot,
+  env: process.env,
+  stdio: "inherit"
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 1);
+});

package/extensions/chrome-relay/README.md

@@ -0,0 +1,36 @@
+# BrowserCtl Relay Extension
+
+This extension connects a Chromium-based browser tab layer to the local BrowserCtl extension bridge.
+
+## Load Unpacked
+
+1. Open `chrome://extensions` (or `edge://extensions` in Edge).
+2. Enable **Developer mode**.
+3. Click **Load unpacked**.
+4. Select this folder: `extensions/chrome-relay`.
+
+This extension uses the `debugger` permission to collect console/network telemetry for agent-side inspection.
+
+## Configure
+
+1. Open the extension popup.
+2. Set `Bridge URL` to your bridge endpoint.
+3. Set token to match `BROWSERD_CHROME_RELAY_EXTENSION_TOKEN` (required).
+4. Click **Save** and then **Reconnect**.
+
+Default bridge URL:
+
+- `ws://127.0.0.1:9223/bridge`
+
+## Troubleshooting In Popup
+
+The popup now includes a dedicated troubleshooting section:
+
+- **Run Diagnostics**: compares extension-side connection state with relay-side `/browserctl/relay/status`.
+- **Copy Report**: copies a JSON diagnostics report with status snapshots and recommended actions.
+- **Guidance list**: shows targeted fixes for common issues (URL mismatch, token mismatch, relay unreachable, stale connection).
+
+## Language Switch
+
+Use the popup language selector to switch between **English** and **Chinese (中文)**.
+The selected language is persisted in extension local storage and applied on the next popup open.