@jobshimo/browser-link 0.0.1 → 0.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Martín Miguel Bernal
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Martín Miguel Bernal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,83 +1,102 @@
-# @jobshimo/browser-link
-
-> ⚠️  **Read this before installing**
->
-> This package opens a bridge between Claude Code and the Chrome tabs you
-> explicitly enable through a companion extension. On every tab where you
-> press "Conectar" in the extension popup, the agent can read its DOM,
-> click, type, run arbitrary JavaScript, and follow links — including any
-> logged-in session, saved card, wallet, banking page or admin panel that
-> tab is currently showing.
->
-> Treat the agent like a junior dev with remote control of those tabs.
-> Only enable tabs where you would let an automated process act on your
-> behalf, and disconnect them when you are done. You are responsible for
-> every action the agent performs on the tabs you explicitly enable.
-
-MCP server that bridges Claude Code to the Chrome tabs you grant access to,
-through a small WebSocket relay and a companion Chrome extension. Ships
-with a persistent UI map so the agent remembers selectors, flows and
-gotchas it learned about each app, across sessions.
-
-## Install
-
-```bash
-npm install -g @jobshimo/browser-link
-```
-
-This puts the `browser-link` binary on your PATH on macOS, Linux and Windows.
-
-## Set it up
-
-The fastest path is the interactive menu:
-
-```bash
-browser-link
-```
-
-That opens the welcome / disclaimer screen (English or Spanish), and then
-the setup menu where you can register browser-link with Claude Code, see
-the Chrome extension install steps, run a doctor diagnose, and open the
-about / help page.
-
-If you prefer direct commands:
-
-```bash
-browser-link install        # register browser-link in Claude Code
-browser-link extension      # show the Chrome extension assets path + steps
-browser-link doctor         # diagnose current setup
-browser-link about          # what this is, how it works, every tool
-```
-
-After `install`, restart Claude Code. After `extension`, follow the printed
-steps to load the unpacked extension in Chrome. Then click "Conectar" on
-every tab you want the agent to reach — and only on those.
-
-## Tools exposed
-
-Browser bridge: `browser.list_tabs`, `browser.ping`, `browser.navigate`,
-`browser.snapshot`, `browser.click`, `browser.type`, `browser.evaluate`,
-`browser.console`, `browser.network`, `browser.network_body`.
-
-UI map (persistent across sessions): `browser.map.recall`,
-`browser.map.save`, `browser.map.record_use`, `browser.map.forget`,
-`browser.map.rename_app`, `browser.map.apps`.
-
-The server also ships usage instructions for the agent via the MCP
-`initialize` handshake — no manual prompt setup required.
-
-## Where the data lives
-
-```
-macOS    ~/Library/Application Support/browser-link/map.db
-Linux    $XDG_DATA_HOME/browser-link/map.db   (default: ~/.local/share/browser-link/map.db)
-Windows  %APPDATA%/browser-link/map.db
-```
-
-Override with `BROWSER_LINK_DATA_DIR`. The database is local to your
-machine and never uploaded anywhere by this package. The WebSocket relay
-binds to `127.0.0.1:17529` (loopback only).
-
-## License
-
-MIT — see [LICENSE](https://github.com/jobshimo/browser-link/blob/main/LICENSE).
+# @jobshimo/browser-link
+
+> ⚠️ **Read this before installing**
+>
+> This package opens a bridge between your MCP client (Claude Code,
+> OpenCode, …) and the Chrome tabs you explicitly enable through a
+> companion extension. On every tab where you press "Conectar" in the
+> extension popup, the agent can read its DOM, click, type, run
+> arbitrary JavaScript, and follow links — including any logged-in
+> session, saved card, wallet, banking page or admin panel that tab is
+> currently showing.
+>
+> Treat the agent like a junior dev with remote control of those tabs.
+> Only enable tabs where you would let an automated process act on your
+> behalf, and disconnect them when you are done. You are responsible for
+> every action the agent performs on the tabs you explicitly enable.
+
+MCP server that bridges any MCP-compatible client (Claude Code, OpenCode,
+and friends) to the Chrome tabs you grant access to, through a small
+WebSocket relay and a companion Chrome extension. Ships with a persistent
+UI map so the agent remembers selectors, flows and gotchas it learned
+about each app, across sessions.
+
+## Install
+
+```bash
+npm install -g @jobshimo/browser-link
+```
+
+This puts the `browser-link` binary on your PATH on macOS, Linux and Windows.
+
+## Set it up
+
+The fastest path is the interactive menu (built on `@clack/prompts` —
+flicker-free in PowerShell, Windows Terminal, macOS Terminal, iTerm, every
+Linux TTY):
+
+```bash
+browser-link
+```
+
+That opens the welcome / disclaimer screen (English or Spanish), and then
+the setup menu where you can register browser-link with **Claude Code** or
+**OpenCode**, see the Chrome extension install steps, run a doctor
+diagnose, and open the about / help page.
+
+If you prefer direct commands:
+
+```bash
+browser-link install                       # register in every detected client
+browser-link install --client claude       # register only in Claude Code
+browser-link install --client opencode     # register only in OpenCode
+browser-link uninstall --client opencode   # remove from one client
+browser-link extension                     # show the Chrome extension assets path + steps
+browser-link doctor                        # diagnose current setup
+browser-link about                         # what this is, how it works, every tool
+```
+
+After `install`, restart the MCP client so it picks up the new entry.
+After `extension`, follow the printed steps to load the unpacked extension
+in Chrome. Then click "Conectar" on every tab you want the agent to reach
+— and only on those.
+
+## Supported MCP clients
+
+| Client                                            | Config file written                                            |
+| ------------------------------------------------- | -------------------------------------------------------------- |
+| [Claude Code](https://docs.claude.com/claude-code) | `~/.claude.json` (`%USERPROFILE%\.claude.json` on Windows)     |
+| [OpenCode](https://opencode.ai)                   | `~/.config/opencode/opencode.json` on **every** OS (Win incl.) |
+
+Both registrations are idempotent — re-running `install` updates the
+entry instead of duplicating it. `uninstall --client <id>` removes it
+cleanly without touching anything else in the file.
+
+## Tools exposed
+
+Browser bridge: `browser.list_tabs`, `browser.ping`, `browser.navigate`,
+`browser.snapshot`, `browser.click`, `browser.type`, `browser.evaluate`,
+`browser.console`, `browser.network`, `browser.network_body`.
+
+UI map (persistent across sessions): `browser.map.recall`,
+`browser.map.save`, `browser.map.record_use`, `browser.map.forget`,
+`browser.map.rename_app`, `browser.map.apps`.
+
+The server also ships usage instructions for the agent via the MCP
+`initialize` handshake — no manual prompt setup required.
+
+## Where the data lives
+
+```
+macOS    ~/Library/Application Support/browser-link/map.db
+Linux    $XDG_DATA_HOME/browser-link/map.db   (default: ~/.local/share/browser-link/map.db)
+Windows  %APPDATA%/browser-link/map.db
+```
+
+Override with `BROWSER_LINK_DATA_DIR`. The database is local to your
+machine and never uploaded anywhere by this package. The WebSocket relay
+binds to `127.0.0.1:17529` (loopback only).
+
+## License
+
+MIT — see [LICENSE](https://github.com/jobshimo/browser-link/blob/main/LICENSE).

package/dist/cli.js

@@ -5,25 +5,25 @@ import { uninstallAll, uninstallFor } from './commands/uninstall.js';
 import { printExtensionInstructions } from './commands/extension.js';
 import { printAbout } from './commands/about.js';
 import { loadConfig } from './config.js';
-const HELP = `browser-link — bridge Claude Code to the Chrome tabs you enable.
-
-Usage:
-  browser-link                  When invoked from an interactive terminal,
-                                opens a setup menu (register Claude Code,
-                                show extension steps, run doctor, about).
-                                When invoked by Claude Code (no TTY),
-                                starts the MCP server over stdio.
-  browser-link install          Register browser-link with Claude Code.
-  browser-link uninstall        Remove the registration.
-  browser-link extension        Show the path of the Chrome extension assets
-                                and per-OS install instructions.
-  browser-link doctor           Diagnose current setup (Claude Code, server, extension, map DB).
-  browser-link about            Show the full explanation of what this is and how it works.
-  browser-link help             This message.
-
-Environment:
-  BROWSER_LINK_DATA_DIR         Override the DB location (defaults per OS).
-  BROWSER_LINK_BIN              Override the command stored in client configs
+const HELP = `browser-link — bridge Claude Code to the Chrome tabs you enable.
+
+Usage:
+  browser-link                  When invoked from an interactive terminal,
+                                opens a setup menu (register Claude Code,
+                                show extension steps, run doctor, about).
+                                When invoked by Claude Code (no TTY),
+                                starts the MCP server over stdio.
+  browser-link install          Register browser-link with Claude Code.
+  browser-link uninstall        Remove the registration.
+  browser-link extension        Show the path of the Chrome extension assets
+                                and per-OS install instructions.
+  browser-link doctor           Diagnose current setup (Claude Code, server, extension, map DB).
+  browser-link about            Show the full explanation of what this is and how it works.
+  browser-link help             This message.
+
+Environment:
+  BROWSER_LINK_DATA_DIR         Override the DB location (defaults per OS).
+  BROWSER_LINK_BIN              Override the command stored in client configs
                                 (e.g. "node /path/to/dist/index.js" for dev).`;
 function parseClient(argv) {
     const idx = argv.findIndex((a) => a === '--client');

package/dist/commands/about.d.ts

@@ -1,23 +1,25 @@
 import type { Language } from './welcome.js';
 interface AboutI18n {
     title: string;
-    whatItIs: string[];
-    howItWorks: string[];
-    bridgeTools: {
-        title: string;
-        items: string[];
-    };
-    mapTools: {
-        title: string;
-        items: string[];
-    };
-    privacy: string[];
-    whereToGetHelp: string[];
-    prompt: string;
+    whatTitle: string;
+    what: string;
+    howTitle: string;
+    how: string;
+    bindingTitle: string;
+    binding: string;
+    bridgeToolsTitle: string;
+    bridgeTools: string;
+    mapToolsTitle: string;
+    mapTools: string;
+    privacyTitle: string;
+    privacy: string;
+    helpTitle: string;
+    help: string;
 }
 export declare const I18N_ABOUT: Record<Language, AboutI18n>;
-export declare function buildAboutScreen(t: AboutI18n): string;
+/** Interactive about screen — used from the setup menu. Falls back to the
+ * caller's prompt loop afterwards (no explicit "press any key"). */
 export declare function runAbout(language?: Language): Promise<void>;
-/** Plain-text render of About for non-interactive output (browser-link about). */
+/** Non-interactive about — `browser-link about`. Plain output, no prompts. */
 export declare function printAbout(language?: Language): void;
 export {};