@babtab/relay 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/README.es.md +7 -5
  3. package/README.hi.md +7 -5
  4. package/README.ja.md +7 -5
  5. package/README.ko.md +7 -5
  6. package/README.md +9 -6
  7. package/README.pt-BR.md +7 -5
  8. package/README.zh-TW.md +9 -6
  9. package/dist/relay.cjs +45 -268
  10. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -6,6 +6,60 @@ and [Semantic Versioning](https://semver.org/).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.3.2] — 2026-11-07
10
+
11
+ ### Fixed
12
+
13
+ - Install no longer stalls when the npm registry is slow or unreachable: generated
14
+ MCP configs (setup CLI and every Side Panel one-click link/snippet) now launch
15
+ `npx -y --prefer-offline @babtab/relay@<version> stdio …`.
16
+ - Codex: `setup` writes `startup_timeout_sec = 60` so the first-run download is not
17
+ killed by Codex's short default startup timeout.
18
+ - Claude Code: re-running `setup` replaces an existing `babtab` entry instead of failing.
19
+ - Pairing token file is written atomically (tmp + rename) so a crash cannot wipe tokens.
20
+ - HTTP JSON endpoints require `Content-Type: application/json` (415 otherwise), so web
21
+ pages can no longer send preflight-free cross-origin POSTs to the local relay.
22
+ - Windows: port-conflict and PATH-check hints use `netstat`/`where.exe` instead of `lsof`/`command -v`.
23
+ - Side Panel skips re-rendering when polled approvals/events are unchanged.
24
+ - Relay rejects requests whose `Host` header is not loopback (HTTP 403 / WS close 1008) when bound
25
+ to loopback, closing a DNS-rebinding path from web pages.
26
+ - Relay answers the extension's app-level `ping` with `pong`; the extension now reconnects when a
27
+ relay that previously answered pings goes silent (half-open sockets after sleep / network change).
28
+ - Stdio bridge: if the relay owner process exits mid-session, the surviving bridge restarts the
29
+ relay and retries once on `ECONNREFUSED`, and polls every 500ms while the relay is down.
30
+ - Stdio bridge negotiates MCP protocol versions (2024-11-05, 2025-03-26, 2025-06-18) instead of
31
+ always answering 2024-11-05.
32
+ - Stdio bridge skips the extra health/status round-trips before a tool call when the background
33
+ poll succeeded within the last 1.5s (lower per-call latency and load).
34
+ - Windows: generated MCP configs use `cmd /c npx …` so clients can spawn the `npx.cmd` shim.
35
+
36
+ - Stdio bridge no longer loops forever on `Waiting for the local bridge to start…`
37
+ when the configured port is held by a frozen or paused process that never
38
+ answers `/health`. After a short grace window (default 8s; override with
39
+ `BABTAB_START_GRACE_MS`) it returns an actionable "port is held / not
40
+ responding" error instead (includes `lsof` probe and a suggested alternate port).
41
+
42
+ ### Changed
43
+
44
+ - Extension onboarding: louder pairing banner (inline Approve), PATH/Node
45
+ diagnose panel, post-Approve first-command prompt, Try next port (persists
46
+ the new port via the same Save & Connect path) + free-port probe, clearer
47
+ site-access vs Chrome host permission copy, Codex/Antigravity install
48
+ checklists.
49
+ - Docs: align deployment claims with the stdio bridge (Node/`npx` required once;
50
+ no longer claim “extension only / no localhost”).
51
+
52
+ ## [0.3.1] — 2026-10-05
53
+
54
+ ### Changed
55
+
56
+ - Docs: link the published Chrome Web Store listing
57
+ (https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
58
+ from all 7 READMEs and the privacy page footer; replaced the outdated
59
+ "Load unpacked / pending store publication" steps with store install.
60
+ No code changes — still pairs with extension 0.3.0; no re-pairing needed.
61
+ - Install links and setup commands pin `@babtab/relay@0.3.1`.
62
+
9
63
  ## [0.3.0] — 2026-10-03
10
64
 
11
65
  ### Added
package/README.es.md CHANGED
@@ -5,13 +5,15 @@
5
5
  [![Versión](https://img.shields.io/npm/v/@babtab/relay.svg)](https://www.npmjs.com/package/@babtab/relay)
6
6
  [![Licencia](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
7
7
 
8
- El **servidor relay local** para la extensión Babtab de Chrome: conecta tu agente de IA (Cursor / Pi / Claude Code / …) con tu Chrome real.
8
+ > **Requiere la extensión Babtab:** [Instalar Babtab desde Chrome Web Store](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
9
+
10
+ El **servidor relay local** para la [extensión Babtab de Chrome](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb): conecta tu agente de IA (Cursor / Pi / Claude Code / …) con tu Chrome real.
9
11
 
10
12
  Las extensiones MV3 no pueden escuchar en un puerto, así que este pequeño programa actúa como puente. Se ejecuta en `localhost`, por lo que el tráfico nunca sale de tu máquina. El relay reenvía solicitudes y resultados solo en memoria (incluidas observaciones de página y capturas); no almacena el contenido de las páginas.
11
13
 
12
- ## Instalación recomendada (0.3.0)
14
+ ## Instalación recomendada (0.3.2)
13
15
 
14
- Requiere Node.js 20+. Instala la extensión desde Chrome Web Store y pulsa **Add to Cursor** / **Add to VS Code** / **Add to Hermes** (botones de un clic) en Babtab; **Add to Codex** / **Add to Antigravity** copian un fragmento de instalación. Confirma y activa Babtab en Cursor, vuelve a Chrome y pulsa **Approve**. Tu herramienta de IA inicia el relay automáticamente; no necesitas mantener una terminal abierta. Para otras herramientas, usa **Other AI tools / install with a command**.
16
+ Requiere Node.js 20+. Instala la extensión desde [Chrome Web Store](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb) y pulsa **Add to Cursor** / **Add to VS Code** / **Add to Hermes** (botones de un clic) en Babtab; **Add to Codex** / **Add to Antigravity** copian un fragmento de instalación. Confirma y activa Babtab en Cursor, vuelve a Chrome y pulsa **Approve**. Tu herramienta de IA inicia el relay automáticamente; no necesitas mantener una terminal abierta. Para otras herramientas, usa **Other AI tools / install with a command**.
15
17
 
16
18
  Detén el relay manual anterior antes de cambiar. Consulta la [guía actualizada](README.md). Las instrucciones siguientes corresponden a la conexión HTTP manual.
17
19
 
@@ -30,9 +32,9 @@ Agente de IA (Cursor / Pi …) ←→ Relay (local :3000) ←→ Extensión de C
30
32
 
31
33
  ### Paso 1: Instala la extensión de Chrome
32
34
 
33
- `chrome://extensions` → activa el **modo de desarrollador** → **Cargar descomprimida** → selecciona la carpeta `dist`.
35
+ [Instala Babtab desde Chrome Web Store](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb).
34
36
 
35
- > Cuando se publique en la Chrome Web Store, este paso será "instalar desde la tienda".
37
+ > El modo de desarrollador / Cargar descomprimida es solo para desarrollo local.
36
38
 
37
39
  ### Paso 2: Inicia el relay (elige una, mismo resultado)
38
40
 
package/README.hi.md CHANGED
@@ -5,13 +5,15 @@
5
5
  [![संस्करण](https://img.shields.io/npm/v/@babtab/relay.svg)](https://www.npmjs.com/package/@babtab/relay)
6
6
  [![लाइसेंस](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
7
7
 
8
- Babtab Chrome एक्सटेंशन के लिए **लोकल relay सर्वर**: यह आपके AI एजेंट (Cursor / Pi / Claude Code / …) को आपके असली Chrome से जोड़ता है।
8
+ > **Babtab एक्सटेंशन आवश्यक है:** [Chrome Web Store से Babtab इंस्टॉल करें](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
9
+
10
+ [Babtab Chrome एक्सटेंशन](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb) के लिए **लोकल relay सर्वर**: यह आपके AI एजेंट (Cursor / Pi / Claude Code / …) को आपके असली Chrome से जोड़ता है।
9
11
 
10
12
  MV3 एक्सटेंशन स्वयं किसी पोर्ट पर listen नहीं कर सकते, इसलिए यह छोटा प्रोग्राम bridge का काम करता है। यह `localhost` पर चलता है, इसलिए ट्रैफ़िक आपकी मशीन से बाहर कभी नहीं जाता। Relay अनुरोध और परिणाम सिर्फ़ मेमोरी में आगे बढ़ाता है (पेज अवलोकन और स्क्रीनशॉट सहित); यह पेज सामग्री को store नहीं करता।
11
13
 
12
- ## अनुशंसित सेटअप (0.3.0)
14
+ ## अनुशंसित सेटअप (0.3.2)
13
15
 
14
- Node.js 20+ आवश्यक है। Chrome Web Store से एक्सटेंशन इंस्टॉल करें और Babtab में **Add to Cursor** / **Add to VS Code** / **Add to Hermes** जैसे वन-क्लिक बटन दबाएँ (**Add to Codex** / **Add to Antigravity** इंस्टॉल स्निपेट कॉपी करते हैं)। Cursor में जोड़ने और सक्षम करने की पुष्टि करें, फिर Chrome में लौटकर **Approve** दबाएँ। AI टूल Relay को अपने आप शुरू करता है; टर्मिनल खुला रखने की जरूरत नहीं है। अन्य टूल के लिए **Other AI tools / install with a command** चुनें।
16
+ Node.js 20+ आवश्यक है। [Chrome Web Store से एक्सटेंशन इंस्टॉल करें](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb) और Babtab में **Add to Cursor** / **Add to VS Code** / **Add to Hermes** जैसे वन-क्लिक बटन दबाएँ (**Add to Codex** / **Add to Antigravity** इंस्टॉल स्निपेट कॉपी करते हैं)। Cursor में जोड़ने और सक्षम करने की पुष्टि करें, फिर Chrome में लौटकर **Approve** दबाएँ। AI टूल Relay को अपने आप शुरू करता है; टर्मिनल खुला रखने की जरूरत नहीं है। अन्य टूल के लिए **Other AI tools / install with a command** चुनें।
15
17
 
16
18
  बदलने से पहले पुराना मैन्युअल Relay बंद करें। [नवीनतम गाइड](README.md) देखें। नीचे दिए गए निर्देश मैन्युअल HTTP कनेक्शन के लिए हैं।
17
19
 
@@ -30,9 +32,9 @@ AI एजेंट (Cursor / Pi …) ←→ Relay (लोकल :3000) ←→ Ch
30
32
 
31
33
  ### चरण 1: Chrome एक्सटेंशन इंस्टॉल करें
32
34
 
33
- `chrome://extensions` → **Developer mode** चालू करें → **Load unpacked** → `dist` फ़ोल्डर चुनें।
35
+ [Chrome Web Store से Babtab इंस्टॉल करें](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)।
34
36
 
35
- > Chrome Web Store पर प्रकाशित होने के बाद यह चरण "स्टोर से इंस्टॉल करें" हो जाएगा।
37
+ > Developer mode / Load unpacked सिर्फ़ स्थानीय विकास के लिए है।
36
38
 
37
39
  ### चरण 2: Relay शुरू करें (कोई एक चुनें, परिणाम समान)
38
40
 
package/README.ja.md CHANGED
@@ -5,13 +5,15 @@
5
5
  [![バージョン](https://img.shields.io/npm/v/@babtab/relay.svg)](https://www.npmjs.com/package/@babtab/relay)
6
6
  [![ライセンス](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
7
7
 
8
- Babtab Chrome 拡張機能のための**ローカル中継サーバー**です。あなたの AI エージェント（Cursor / Pi / Claude Code / …）を、実際の Chrome につなぎます。
8
+ > **Babtab 拡張機能が必要です：**[Chrome ウェブストアから Babtab をインストール](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
9
+
10
+ [Babtab Chrome 拡張機能](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)のための**ローカル中継サーバー**です。あなたの AI エージェント（Cursor / Pi / Claude Code / …）を、実際の Chrome につなぎます。
9
11
 
10
12
  MV3 の拡張機能は自分でポートを listen できないため、この小さなプログラムが橋渡しをします。`localhost` 上で動作するので、通信が PC の外に出ることはありません。Relay はリクエストと結果をメモリ上でのみ転送します（ページ観測やスクリーンショットを含みます）。ページ内容を保存することはありません。
11
13
 
12
- ## 推奨セットアップ（0.3.0）
14
+ ## 推奨セットアップ（0.3.2）
13
15
 
14
- Node.js 20+ が必要です。Chrome ウェブストアから拡張機能をインストールし、Babtab の **Add to Cursor**／**Add to VS Code**／**Add to Hermes** などのワンクリックボタンを押します（**Add to Codex**／**Add to Antigravity** はインストール用スニペットのコピーです）。Cursor で追加・有効化し、Chrome に戻って **Approve** を押してください。Relay は AI ツールが自動起動するため、ターミナルを開いたままにする必要はありません。ほかの AI ツールは **Other AI tools / install with a command** から設定できます。
16
+ Node.js 20+ が必要です。[Chrome ウェブストアから拡張機能をインストール](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)し、Babtab の **Add to Cursor**／**Add to VS Code**／**Add to Hermes** などのワンクリックボタンを押します（**Add to Codex**／**Add to Antigravity** はインストール用スニペットのコピーです）。Cursor で追加・有効化し、Chrome に戻って **Approve** を押してください。Relay は AI ツールが自動起動するため、ターミナルを開いたままにする必要はありません。ほかの AI ツールは **Other AI tools / install with a command** から設定できます。
15
17
 
16
18
  旧版の手動 Relay を終了してから切り替えてください。詳細は [最新ガイド](README.md) を参照してください。以下は手動 HTTP 接続用の手順です。
17
19
 
@@ -30,9 +32,9 @@ AI エージェント（Cursor / Pi …） ←→ Relay（ローカル :3000）
30
32
 
31
33
  ### ステップ 1：Chrome 拡張機能をインストール
32
34
 
33
- `chrome://extensions` → **デベロッパーモード**を有効化 → **パッケージ化されていない拡張機能を読み込む** → `dist` フォルダを選択。
35
+ [Chrome ウェブストアから Babtab をインストール](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)してください。
34
36
 
35
- > Chrome ウェブストア公開後は、この手順は「ストアからインストール」に変わります。
37
+ > デベロッパーモード / パッケージ化されていない拡張機能の読み込みはローカル開発用です。
36
38
 
37
39
  ### ステップ 2：Relay を起動する（どちらか一方、結果は同じ）
38
40
 
package/README.ko.md CHANGED
@@ -5,13 +5,15 @@
5
5
  [![버전](https://img.shields.io/npm/v/@babtab/relay.svg)](https://www.npmjs.com/package/@babtab/relay)
6
6
  [![라이선스](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
7
7
 
8
- Babtab Chrome 확장 프로그램을 위한 **로컬 중계 서버**입니다. AI 에이전트(Cursor / Pi / Claude Code / …)를 실제 Chrome에 연결해 줍니다.
8
+ > **Babtab 확장 프로그램이 필요합니다:** [Chrome 웹 스토어에서 Babtab 설치](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
9
+
10
+ [Babtab Chrome 확장 프로그램](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)을 위한 **로컬 중계 서버**입니다. AI 에이전트(Cursor / Pi / Claude Code / …)를 실제 Chrome에 연결해 줍니다.
9
11
 
10
12
  MV3 확장 프로그램은 스스로 포트를 listen 할 수 없기 때문에, 이 작은 프로그램이 다리 역할을 합니다. `localhost`에서 동작하므로 트래픽이 컴퓨터 밖으로 나가지 않습니다. Relay는 요청과 결과를 메모리에서만 전달합니다(페이지 관찰 및 스크린샷 포함). 페이지 내용을 저장하지 않습니다.
11
13
 
12
- ## 권장 설치 방법 (0.3.0)
14
+ ## 권장 설치 방법 (0.3.2)
13
15
 
14
- Node.js 20+가 필요합니다. Chrome 웹 스토어에서 확장 프로그램을 설치하고 Babtab의 **Add to Cursor** / **Add to VS Code** / **Add to Hermes** 등 원클릭 버튼을 누르세요(**Add to Codex** / **Add to Antigravity**는 설치 스니펫 복사입니다). Cursor에서 추가 / 활성화한 뒤 Chrome으로 돌아와 **Approve**를 누르세요. AI 도구가 Relay를 자동으로 실행하므로 터미널을 계속 열어 둘 필요가 없습니다. 다른 도구는 **Other AI tools / install with a command**에서 설정할 수 있습니다.
16
+ Node.js 20+가 필요합니다. [Chrome 웹 스토어에서 확장 프로그램을 설치](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)하고 Babtab의 **Add to Cursor** / **Add to VS Code** / **Add to Hermes** 등 원클릭 버튼을 누르세요(**Add to Codex** / **Add to Antigravity**는 설치 스니펫 복사입니다). Cursor에서 추가 / 활성화한 뒤 Chrome으로 돌아와 **Approve**를 누르세요. AI 도구가 Relay를 자동으로 실행하므로 터미널을 계속 열어 둘 필요가 없습니다. 다른 도구는 **Other AI tools / install with a command**에서 설정할 수 있습니다.
15
17
 
16
18
  전환 전에 기존 수동 Relay를 종료하세요. 자세한 내용은 [최신 가이드](README.md)를 참조하세요. 아래는 수동 HTTP 연결용 절차입니다.
17
19
 
@@ -30,9 +32,9 @@ AI 에이전트(Cursor / Pi …) ←→ Relay(로컬 :3000) ←→ Chrome 확장
30
32
 
31
33
  ### 1단계: Chrome 확장 프로그램 설치
32
34
 
33
- `chrome://extensions` → **개발자 모드** 사용 → **압축해제된 확장 프로그램 로드** → `dist` 폴더 선택.
35
+ [Chrome 웹 스토어에서 Babtab을 설치](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)하세요.
34
36
 
35
- > Chrome 웹스토어에 게시되면 이 단계는 "스토어에서 설치"로 바뀝니다.
37
+ > 개발자 모드 / 압축해제된 확장 프로그램 로드는 로컬 개발용입니다.
36
38
 
37
39
  ### 2단계: Relay 실행 (둘 중 하나, 결과는 동일)
38
40
 
package/README.md CHANGED
@@ -5,13 +5,15 @@
5
5
  [![Version](https://img.shields.io/npm/v/@babtab/relay.svg)](https://www.npmjs.com/package/@babtab/relay)
6
6
  [![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
7
7
 
8
- The **local relay server** for the Babtab Chrome extension: it connects your AI agent (Cursor / Pi / Claude Code / …) to your real Chrome.
8
+ > **Requires the Babtab extension:** [Install Babtab from the Chrome Web Store](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
9
+
10
+ The **local relay server** for the [Babtab Chrome extension](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb): it connects your AI agent (Cursor / Pi / Claude Code / …) to your real Chrome.
9
11
 
10
12
  MV3 extensions cannot listen on a port, so this tiny program acts as the bridge. It runs on `localhost`, so traffic never leaves your machine. The relay forwards requests and results in memory, including page observations and screenshots; it does not persist page content.
11
13
 
12
- ## Quick start (0.3.0)
14
+ ## Quick start (0.3.2)
13
15
 
14
- Requires Node.js 20+ and the matching Babtab extension. Install the extension from the **Chrome Web Store**; Developer mode is for local development only.
16
+ Requires Node.js 20+ and the matching [Babtab extension](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb). Install the extension from the [**Chrome Web Store**](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb); Developer mode is for local development only.
15
17
 
16
18
  1. Open Babtab in Chrome and click **Add to Cursor** (or **Add to VS Code** / **VS Code Insiders** / **Add to Hermes** — all one-click).
17
19
  2. Confirm Add / Enable in your AI tool. It starts the local bridge automatically. **Add to Codex** / **Add to Antigravity** copy a one-step install snippet instead (Codex: paste in a terminal — the desktop app shares the CLI config; Antigravity: paste into mcp_config.json and restart the IDE).
@@ -19,14 +21,14 @@ Requires Node.js 20+ and the matching Babtab extension. Install the extension fr
19
21
  4. On a regular website, ask your agent: **Use babtab to observe the current tab**. Approve site access in Babtab if asked.
20
22
 
21
23
  No separate relay command or terminal window is needed. Keep Chrome open.
22
- The first npm download requires internet access. Pairing credentials are stored in `~/.babtab/`, independent of your working directory.
24
+ The first npm download requires internet access (cold start can take a minute). Pairing credentials are stored in `~/.babtab/`, independent of your working directory.
23
25
 
24
26
  ### Other AI tools
25
27
 
26
28
  Open **Other AI tools / install with a command**, choose your tool and copy its personalized command:
27
29
 
28
30
  ```bash
29
- npx -y @babtab/relay@0.3.0 setup --target windsurf --port 3000 --device <device-id-from-extension>
31
+ npx -y @babtab/relay@0.3.2 setup --target windsurf --port 3000 --device <device-id-from-extension>
30
32
  ```
31
33
 
32
34
  Run once, enable / reload MCP in your AI tool, then approve in Chrome. Setup preserves other servers and backs up existing config files. Supported automatic targets: Cursor, Claude Code, Windsurf, Copilot, Codex, Claude Desktop, Antigravity, Devin, Kimi and Hermes. Pi / Manual use the advanced HTTP flow.
@@ -50,7 +52,8 @@ Standalone token storage uses `BABTAB_TOKEN_FILE` or `./data/relay-tokens.json`
50
52
  ### Troubleshooting
51
53
 
52
54
  - **Cursor did not open?** Use the setup command under the button, then reload / enable MCP.
53
- - **No pairing request?** Check that Node 20+ / `npx` is on your AI tool's PATH and Babtab is enabled. Keep the Chrome panel open. The MCP server's stderr logs explain startup problems.
55
+ - **No pairing request?** Check that Node 20+ / `npx` is on your AI tool's PATH (GUI apps often miss shell PATH — verify with `node -v && command -v npx`) and Babtab is enabled. Keep the Chrome panel open. The Side Panel has a **Not seeing a pairing request?** section with a copyable check. MCP stderr logs explain startup problems. The first `npx` download needs network.
56
+ - **Agent says the port is held / not responding?** Another `babtab-relay` is stuck on that port (often a terminal job paused with Ctrl+Z). Free the port (`lsof -iTCP:3000 -sTCP:LISTEN`, then stop that process), reload MCP, or use **Try next port** under Advanced connection settings (it saves the new port for the extension) and re-add Babtab so MCP matches. Do not leave a relay paused in the background.
54
57
  - **Pairing expired?** Keep the AI tool running; it requests a new code automatically.
55
58
  - **Connection stopped?** Reopen your AI tool and Chrome. If you explicitly disconnected, press Reconnect in Babtab.
56
59
  - **Lost / revoked credentials?** Approve the new pairing request; the bridge never bypasses browser approval.
package/README.pt-BR.md CHANGED
@@ -5,13 +5,15 @@
5
5
  [![Versão](https://img.shields.io/npm/v/@babtab/relay.svg)](https://www.npmjs.com/package/@babtab/relay)
6
6
  [![Licença](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
7
7
 
8
- O **servidor relay local** para a extensão Babtab do Chrome: conecta seu agente de IA (Cursor / Pi / Claude Code / …) ao seu Chrome de verdade.
8
+ > **Requer a extensão Babtab:** [Instalar o Babtab pela Chrome Web Store](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
9
+
10
+ O **servidor relay local** para a [extensão Babtab do Chrome](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb): conecta seu agente de IA (Cursor / Pi / Claude Code / …) ao seu Chrome de verdade.
9
11
 
10
12
  Extensões MV3 não conseguem escutar em uma porta, então este programinha age como ponte. Roda em `localhost`, por isso o tráfego nunca sai da sua máquina. O relay encaminha solicitações e resultados apenas em memória (incluindo observações de página e capturas); não armazena o conteúdo das páginas.
11
13
 
12
- ## Instalação recomendada (0.3.0)
14
+ ## Instalação recomendada (0.3.2)
13
15
 
14
- Requer Node.js 20+. Instale a extensão pela Chrome Web Store e clique em **Add to Cursor** / **Add to VS Code** / **Add to Hermes** (botões de um clique) no Babtab; **Add to Codex** / **Add to Antigravity** copiam um trecho de instalação. Confirme e ative no Cursor, volte ao Chrome e clique em **Approve**. A ferramenta de IA inicia o relay automaticamente; não é preciso manter um terminal aberto. Para outras ferramentas, use **Other AI tools / install with a command**.
16
+ Requer Node.js 20+. Instale a extensão pela [Chrome Web Store](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb) e clique em **Add to Cursor** / **Add to VS Code** / **Add to Hermes** (botões de um clique) no Babtab; **Add to Codex** / **Add to Antigravity** copiam um trecho de instalação. Confirme e ative no Cursor, volte ao Chrome e clique em **Approve**. A ferramenta de IA inicia o relay automaticamente; não é preciso manter um terminal aberto. Para outras ferramentas, use **Other AI tools / install with a command**.
15
17
 
16
18
  Encerre o relay manual anterior antes de mudar. Consulte o [guia atualizado](README.md). As instruções abaixo são para conexão HTTP manual.
17
19
 
@@ -30,9 +32,9 @@ Agente de IA (Cursor / Pi …) ←→ Relay (local :3000) ←→ Extensão do Ch
30
32
 
31
33
  ### Passo 1: Instale a extensão do Chrome
32
34
 
33
- `chrome://extensions` → ative o **modo do desenvolvedor** → **Carregar sem compactação** → selecione a pasta `dist`.
35
+ [Instale o Babtab pela Chrome Web Store](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb).
34
36
 
35
- > Quando for publicada na Chrome Web Store, este passo vira "instalar pela loja".
37
+ > O modo do desenvolvedor / Carregar sem compactação é apenas para desenvolvimento local.
36
38
 
37
39
  ### Passo 2: Inicie o relay (escolha um, mesmo resultado)
38
40
 
package/README.zh-TW.md CHANGED
@@ -5,13 +5,15 @@
5
5
  [![版本](https://img.shields.io/npm/v/@babtab/relay.svg)](https://www.npmjs.com/package/@babtab/relay)
6
6
  [![授權](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
7
7
 
8
- Babtab Chrome 擴充功能的**本機中轉伺服器**：把你的 AI Agent（Cursor / Pi / Claude Code / …）接到你真正的 Chrome 上。
8
+ > **需要先安裝 Babtab 外掛：**[從 Chrome 線上應用程式商店安裝 Babtab](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)
9
+
10
+ [Babtab Chrome 擴充功能](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)的**本機中轉伺服器**：把你的 AI Agent（Cursor / Pi / Claude Code / …）接到你真正的 Chrome 上。
9
11
 
10
12
  MV3 擴充功能自己不能 listen port，所以需要這支小程式當橋樑。跑在 `localhost`，流量不出你的電腦；Relay 會在記憶體中轉發請求與結果（包含頁面觀察及截圖），不會儲存頁面內容。
11
13
 
12
- ## 使用者快速開始（0.3.0）
14
+ ## 使用者快速開始（0.3.2）
13
15
 
14
- 需要 Node.js 20+ 與對應新版外掛。一般使用者從 **Chrome Web Store 安裝 Babtab**；開發者模式只供本機測試。
16
+ 需要 Node.js 20+ 與對應新版外掛。一般使用者從 **[Chrome Web Store 安裝 Babtab](https://chromewebstore.google.com/detail/babtab/pnapkckkiphkbciihimdkhofdabnmjhb)**；開發者模式只供本機測試。
15
17
 
16
18
  1. 開啟 Babtab Side Panel，按 **Add to Cursor**（或 **Add to VS Code**／**VS Code Insiders**／**Add to Hermes**，都是一鍵安裝）。
17
19
  2. 在 AI 工具確認加入／啟用 Babtab；它會自動啟動本機橋接程式。**Add to Codex**／**Add to Antigravity** 則是一鍵複製安裝片段（Codex：貼上終端機執行，桌機版共用設定；Antigravity：貼進 mcp_config.json 後重啟 IDE）。
@@ -19,14 +21,14 @@ MV3 擴充功能自己不能 listen port，所以需要這支小程式當橋樑
19
21
  4. 在一般網站分頁，對 AI 說 **Use babtab to observe the current tab**；需要網站授權時在外掛批准。
20
22
 
21
23
  不用先啟動 Relay、不用設定 port、不用保持終端機開啟。使用時保留 Chrome。
22
- 首次 npm 下載需要網路；憑證固定保存在 `~/.babtab/`，更換工作目錄不影響連線。
24
+ 首次 npm 下載需要網路（冷啟動可能要一分鐘）；憑證固定保存在 `~/.babtab/`，更換工作目錄不影響連線。
23
25
 
24
26
  ### 其他 AI 工具
25
27
 
26
28
  開啟 **Other AI tools / install with a command**，選工具並複製專屬指令：
27
29
 
28
30
  ```bash
29
- npx -y @babtab/relay@0.3.0 setup --target windsurf --port 3000 --device <外掛提供的deviceId>
31
+ npx -y @babtab/relay@0.3.2 setup --target windsurf --port 3000 --device <外掛提供的deviceId>
30
32
  ```
31
33
 
32
34
  只需執行一次。指令保留其他 server、備份舊設定，寫入由 AI 工具自動啟動的 MCP 設定。
@@ -60,7 +62,8 @@ AI 工具啟動 `babtab-relay stdio --device … --client … --port 3000`，橋
60
62
  ### 常見問題
61
63
 
62
64
  - **Cursor 沒開啟？** 展開按鈕下方的 setup 指令，執行一次，再重載／啟用 MCP。
63
- - **沒出現配對要求？** 確认 AI 工具的 PATH 找得到 Node 20+／`npx`，且 Babtab 已啟用；保持外掛面板開啟。MCP 日誌會顯示啟動錯誤。
65
+ - **沒出現配對要求？** 確認 AI 工具的 PATH 找得到 Node 20+／`npx`（GUI 應用常缺 shell PATH，可用 `node -v && command -v npx` 檢查），且 Babtab 已啟用；保持外掛面板開啟。Side Panel 有 **Not seeing a pairing request?** 可一鍵複製檢查指令。MCP 日誌會顯示啟動錯誤；首次 `npx` 下載需要網路。
66
+ - **Agent 說埠被佔住／沒有回應？** 通常是舊的 `babtab-relay` 卡住（終端機 Ctrl+Z 暫停很常見）。先釋放該埠（`lsof -iTCP:3000 -sTCP:LISTEN` 後結束該行程），重載 MCP，或在進階連線設定按 **Try next port**（會把新埠存進外掛）後重新加入 Babtab，讓 MCP 埠一致。不要把 relay 留在背景暫停狀態。
64
67
  - **配對碼過期？** 保持 AI 工具執行，橋接程式會自動取得新碼。
65
68
  - **斷線？** 開啟 AI 工具和 Chrome；若先前主動 Disconnect，請在外掛按 Reconnect。
66
69
  - **憑證遺失或撤銷？** 重新批准配對；橋接程式不會跳過人工批准。