@different-ai/opencode-browser 4.5.1 → 4.6.1

package/.opencode/skill/browser-automation/SKILL.md

@@ -13,6 +13,7 @@ metadata:
 - Provide a safe, composable workflow for browsing tasks
 - Use `browser_query` list and index selection to click reliably
 - Confirm state changes after each action
+- Support CLI-first debugging with `opencode-browser tool` commands
 
 ## Best-practice workflow
 
@@ -24,6 +25,16 @@ metadata:
 6. Click, type, or select using `index`
 7. Confirm using `browser_query` or `browser_snapshot`
 
+## CLI-first debugging
+
+- List all available tools: `npx @different-ai/opencode-browser tools`
+- Run one tool directly: `npx @different-ai/opencode-browser tool browser_status`
+- Pass JSON args: `npx @different-ai/opencode-browser tool browser_query --args '{"mode":"page_text"}'`
+- Run smoke test: `npx @different-ai/opencode-browser self-test`
+- After `update`, reload the unpacked extension in `chrome://extensions`
+
+This path is useful for reproducing selector/scroll issues quickly before running a full OpenCode session.
+
 ## Selecting options
 
 - Use `browser_select` for native `<select>` elements
@@ -46,5 +57,7 @@ metadata:
 ## Troubleshooting
 
 - If a selector fails, run `browser_query` with `mode=page_text` to confirm the content exists
-- Use `mode=list` on broad selectors (`button`, `a`, `*[role="button"]`) and choose by index
+- Use `mode=list` on broad selectors (`button`, `a`, `*[role="button"]`, `*[role="listitem"]`) and choose by index
+- For inbox/chat panes, try text selectors first (`text:Subject line`) then verify selection with `browser_query`
+- For scrollable containers, pass both `selector` and `x`/`y` to `browser_scroll` and then verify `scrollTop`
 - Confirm results after each action

package/README.md

@@ -24,6 +24,8 @@ This version is optimized for reliability and predictable multi-session behavior
 bunx @different-ai/opencode-browser@latest install
 ```
 
+Supports macOS, Linux, and Windows (Chrome/Edge/Brave/Chromium).
+
 
 https://github.com/user-attachments/assets/d5767362-fbf3-4023-858b-90f06d9f0b25
 
@@ -58,6 +60,44 @@ Your `opencode.json` or `opencode.jsonc` should contain:
 bunx @different-ai/opencode-browser@latest update
 ```
 
+## CLI tool runner (for local debugging)
+
+Run plugin tools directly from the package CLI (without starting an OpenCode session):
+
+```bash
+# list available browser_* tools
+npx @different-ai/opencode-browser tools
+
+# run a single tool
+npx @different-ai/opencode-browser tool browser_status
+npx @different-ai/opencode-browser tool browser_query --args '{"mode":"page_text"}'
+
+# run built-in end-to-end smoke test (click + text selector + container scroll)
+npx @different-ai/opencode-browser self-test
+```
+
+This is useful for debugging issue reports (for example inbox/chat UIs) before involving a full OpenCode workflow.
+After `update`, reload the unpacked extension in `chrome://extensions` before running `self-test`.
+
+## Chrome Web Store maintainer flow
+
+Build a store-ready extension package:
+
+```bash
+bun run build:cws
+```
+
+Outputs:
+
+- `artifacts/chrome-web-store/opencode-browser-cws-v<version>.zip`
+- `artifacts/chrome-web-store/manifest.chrome-web-store.json`
+
+Submission checklist and guidance:
+
+- `CHROME_WEB_STORE.md`
+- `CHROME_WEB_STORE_REQUEST_TEMPLATE.md`
+- `PRIVACY.md`
+
 ## How it works
 
 ```
@@ -135,6 +175,13 @@ Core primitives:
 - `browser_scroll` (optional `timeoutMs`/`pollMs`)
 - `browser_wait`
 
+Downloads:
+- `browser_download`
+- `browser_list_downloads`
+
+Uploads:
+- `browser_set_file_input` (extension backend supports small files; use agent backend for larger uploads)
+
 Selector helpers (usable in `selector`):
 - `label:Mailing Address: City`
 - `aria:Principal Address: City`
@@ -153,8 +200,8 @@ Diagnostics:
 - [ ] Add tab management tools (`browser_set_active_tab`)
 - [ ] Add navigation helpers (`browser_back`, `browser_forward`, `browser_reload`)
 - [ ] Add keyboard input tool (`browser_key`)
-- [ ] Add download support (`browser_download`, `browser_list_downloads`)
-- [ ] Add upload support (`browser_set_file_input`)
+- [x] Add download support (`browser_download`, `browser_list_downloads`)
+- [x] Add upload support (`browser_set_file_input`)
 
 ## Troubleshooting
 
@@ -174,3 +221,7 @@ npx @different-ai/opencode-browser uninstall
 ```
 
 Then remove the unpacked extension in `chrome://extensions` and remove the plugin from `opencode.json` or `opencode.jsonc`.
+
+## Privacy
+
+- Privacy policy: `PRIVACY.md`

package/bin/broker.cjs

@@ -7,7 +7,23 @@ const os = require("os");
 const path = require("path");
 
 const BASE_DIR = path.join(os.homedir(), ".opencode-browser");
-const SOCKET_PATH = path.join(BASE_DIR, "broker.sock");
+const SOCKET_PATH = getBrokerSocketPath();
+
+function getSafePipeName() {
+  try {
+    const username = os.userInfo().username || "user";
+    return `opencode-browser-${username}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+  } catch {
+    return "opencode-browser";
+  }
+}
+
+function getBrokerSocketPath() {
+  const override = process.env.OPENCODE_BROWSER_BROKER_SOCKET;
+  if (override) return override;
+  if (process.platform === "win32") return `\\\\.\\pipe\\${getSafePipeName()}`;
+  return path.join(BASE_DIR, "broker.sock");
+}
 
 fs.mkdirSync(BASE_DIR, { recursive: true });
 
@@ -53,7 +69,7 @@ function writeJsonLine(socket, msg) {
 }
 
 function wantsTab(toolName) {
-  return !["get_tabs", "get_active_tab", "open_tab"].includes(toolName);
+  return !["get_tabs", "get_active_tab", "open_tab", "list_downloads"].includes(toolName);
 }
 
 // --- State ---