From 47622e61cc8552d2209079a94346dfaed86a799a Mon Sep 17 00:00:00 2001
From: dkisser <437631891@qq.com>
Date: Tue, 23 Jun 2026 13:56:00 +0800
Subject: [PATCH] docs(readme): emphasize cross-agent positioning over CLI
- Reframe Browser Bridge as a bridge protocol for any agent
- CLI is now listed as one consumer alongside Claude Code skill and custom integrations
- Add 'Use it from any agent' quick-start step in both EN and CN
- Soften MCP mention and fix 'Claude Code skills' plural
---
README.md | 19 ++++++++++++-------
README_CN.md | 17 +++++++++++------
2 files changed, 23 insertions(+), 13 deletions(-)
diff --git a/README.md b/README.md
index 368daf9..07a5128 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,8 @@
Browser as a Tool for Any Agent
- Let any AI agent, LLM, or script control your local browser through a simple CLI.
+ Let any AI agent, LLM, or script control your local browser.
+ Use the included CLI, the Claude Code skill, or any integration that speaks the bridge protocol.
Your sessions, cookies, and credentials stay local.
@@ -32,9 +33,9 @@
## ✨ Features
-- 🤖 **Agent-ready CLI** — LLMs and scripts call one command to drive the browser.
+- 🤖 **Agent-ready interface** — one bridge protocol, consumed via CLI, Claude Code skill, or custom integration.
- 🔒 **Local session, cloud control** — reuse your logged-in browser; no cloud browser or cookie sync needed.
-- 🌉 **WebSocket bridge** — CLI talks to a server, server talks to a local proxy, proxy talks to Chrome.
+- 🌉 **WebSocket bridge** — agents talk to a server, server talks to a local proxy, proxy talks to Chrome.
- 🧩 **Chrome Extension (MV3)** — built with Vite, loads as an unpacked extension.
- ⚡ **Bun + TypeScript** — fast startup, strict types, one package manager for the whole monorepo.
- 🧪 **Dev-friendly** — hot reload for server, proxy, and extension.
@@ -43,7 +44,7 @@
## 🚀 Quick Start
-### 1. Install the CLI and extension
+### 1. Install the bridge and extension
```bash
curl -fsSL https://github.com/dkisser/browser-bridge/releases/latest/download/install.sh | bash
@@ -65,6 +66,10 @@ That’s it. The command travels from CLI → WebSocket server → local proxy
> Use `bridge browser:list` to see the `` of your connected Chrome instance.
+### 3. Use it from any agent
+
+The `bridge` CLI is just one consumer of the bridge protocol. Browser Bridge ships with a ready-to-use Claude Code skill in [`./skills`](./skills/browser-bridge-user/SKILL.md), and anything that can open a WebSocket — for example, an MCP server you build, a custom SDK, or another agent framework — can send commands the same way.
+
---
## 🏗️ Architecture
@@ -84,7 +89,7 @@ That’s it. The command travels from CLI → WebSocket server → local proxy
| Layer | Component | Role |
|-------|-----------|------|
-| Cloud / shared | CLI | Human or agent-facing command interface. |
+| Cloud / shared | Interfaces | Agent-facing entry points: CLI, Claude Code skill, or any custom integration. |
| Cloud / shared | WebSocket Server | Routes commands to the right local proxy. |
| Local | Local Proxy | Maintains the outbound connection from your machine. |
| Local | Chrome Extension | Receives messages and executes browser actions. |
@@ -101,7 +106,7 @@ See [`docs/architecture-diagram.html`](./docs/architecture-diagram.html) for the
curl -fsSL https://github.com/dkisser/browser-bridge/releases/latest/download/install.sh | bash
```
-### Option B: One-line installer with Claude Code skills
+### Option B: One-line installer with Claude Code skill
If you already have [Claude Code](https://claude.ai/code), clone the repo and run the installer from the project root. It will install Browser Bridge plus the ready-to-use skill in `./skills`:
@@ -149,7 +154,7 @@ bun run cli
```
Browser-Bridge/
├── apps/
-│ ├── cli/ # CLI entrypoint
+│ ├── cli/ # CLI entrypoint (one bridge protocol consumer)
│ ├── extension/ # Chrome Extension (Manifest V3, Vite)
│ ├── local-proxy/ # Local WebSocket proxy
│ └── websocket/ # WebSocket server, client, and protocol
diff --git a/README_CN.md b/README_CN.md
index 02ab81b..7c22209 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -7,7 +7,8 @@
让浏览器成为任何 Agent 的工具
- 让任何 AI Agent、LLM 或脚本通过简单 CLI 控制你的本地浏览器。
+ 让任何 AI Agent、LLM 或脚本控制你的本地浏览器。
+ 可以使用内置 CLI、Claude Code skill，或任何能使用 bridge 协议的集成。
会话、Cookie 和凭证始终保留在本地。
@@ -32,9 +33,9 @@
## ✨ 功能特性
-- 🤖 **Agent 就绪的 CLI** —— LLM 和脚本只需调用一个命令即可驱动浏览器。
+- 🤖 **Agent 就绪的接口** —— 一个 bridge 协议，可通过 CLI、Claude Code skill 或自定义集成来消费。
- 🔒 **本地会话，云端控制** —— 复用你已登录的浏览器，无需云端浏览器或同步 Cookie。
-- 🌉 **WebSocket 桥接** —— CLI → 服务端 → 本地代理 → Chrome。
+- 🌉 **WebSocket 桥接** —— Agent 与服务端通信，服务端路由到本地代理，再连接到 Chrome。
- 🧩 **Chrome 扩展（MV3）** —— 基于 Vite 构建，以解压扩展形式加载。
- ⚡ **Bun + TypeScript** —— 启动快、类型严格、整个 monorepo 一个包管理器。
- 🧪 **开发友好** —— 服务端、代理、扩展均支持热重载。
@@ -43,7 +44,7 @@
## 🚀 快速开始
-### 1. 安装 CLI 和扩展
+### 1. 安装 bridge 与扩展
```bash
curl -fsSL https://github.com/dkisser/browser-bridge/releases/latest/download/install.sh | bash
@@ -65,6 +66,10 @@ bridge navigate https://github.com --browser
> 使用 `bridge browser:list` 查看已连接 Chrome 实例的 ``。
+### 3. 从任意 Agent 使用
+
+`bridge` CLI 只是 bridge 协议的一种消费者。Browser Bridge 在 [`./skills`](./skills/browser-bridge-user/SKILL.md) 中内置了开箱即用的 Claude Code skill；任何能打开 WebSocket 的客户端——例如你自己构建的 MCP server、自定义 SDK 或其他 Agent 框架——都可以用同样的方式发送命令。
+
---
## 🏗️ 架构
@@ -84,7 +89,7 @@ bridge navigate https://github.com --browser
| 层级 | 组件 | 职责 |
|------|------|------|
-| 云端 / 共享 | CLI | 面向人或 Agent 的命令接口。 |
+| 云端 / 共享 | 接口层 | 面向 Agent 的入口：CLI、Claude Code skill 或任何自定义集成。 |
| 云端 / 共享 | WebSocket Server | 将命令路由到对应的本地代理。 |
| 本地 | Local Proxy | 从本机维持与服务端的长连接。 |
| 本地 | Chrome Extension | 接收消息并执行浏览器操作。 |
@@ -149,7 +154,7 @@ bun run cli
```
Browser-Bridge/
├── apps/
-│ ├── cli/ # CLI 入口
+│ ├── cli/ # CLI 入口（bridge 协议消费者之一）
│ ├── extension/ # Chrome 扩展（Manifest V3，Vite）
│ ├── local-proxy/ # 本地 WebSocket 代理
│ └── websocket/ # WebSocket 服务端、客户端和协议