ridealong

RIDEALONG

由 AI 驾驶的浏览器。一路同行，随时接管。
适用于 Claude Code 的 MCP 服务 · 真实的 Google Chrome · 实时 H.264 画面 · 专为人工参与而设计

网站 · 快速开始 · 法语网站 · 法语 README

---

每个浏览器 MCP 都让 Agent 在黑暗中点击操作。Ridealong 让你坐上副驾驶。Claude 驾驶真实的 Chrome；你打开一个链接，就能清楚看到它看到的内容、点击的位置和输入的文字——当它遇到登录、验证码或付款时，你可以用手机接管方向盘，然后再交还给它。

在 Claude Code 中

Ridealong 是一个 MCP 服务：Claude 像调用其他工具一样调用它的工具，但每一步都会显示在实时画面中，William 的指针和消息也会返回到对话记录中，敏感操作则需要等待批准。

在手机上

不只是又一个浏览器 MCP

为什么选择 Ridealong

	常见的浏览器 MCP	Ridealong
浏览器	无头 Chromium	真实的 Google Chrome（编解码器、扩展程序、你的个人资料）
查看 Agent 操作	按需截图	实时串流，由 GPU 编码的 H.264，延迟约 150 ms
介入	停止运行	手动模式：你的点击、按键和滚动会直接作用于页面
敏感操作	只能寄希望于安全	ask_approval：在手机上批准 / 拒绝，工具会等待
引导 Agent	输入一长串提示词	在实时画面中点按元素，或发送一条简短消息
密钥	出现在对话记录中	绝不会：手动输入不会被存储、记录，也不会对 Claude 可见
会话中断	手动重新连接	自动恢复的中继服务 + 不会失效的实时画面

快速开始

在 Claude 操控的机器上 — 无需托管：

claude mcp add ridealong -- npx -y -p ridealong-mcp ridealong

或者作为 Claude Code 插件：claude plugin marketplace add williamblaismedia-create/ridealong 然后运行 claude plugin install ridealong@ridealong。从源码安装：git clone … && npm ci && npm run build && claude mcp add ridealong -- "$PWD/scripts/ridealong-local.sh"。

然后，在 Claude Code 中输入：“打开 timeliner.io，给我看看实时视图”。 你会获得一个签名链接（http://127.0.0.1:9400/#token=…）。在某台设备上打开一次， 之后裸地址 30 天内都有效 — 把它加入书签。

在 Docker 中（在 Xvfb 下运行 Chrome、ffmpeg、持久化配置文件）：

docker build -t ridealong . && claude mcp add ridealong -- docker run -i --rm -p 9400:9400 -v ridealong-data:/data ridealong

在配备 NVIDIA GPU、Cloudflare 隧道，以及能在笔记本休眠时保持运行的中继的常开服务器上：参考配置见 docs/DEPLOIEMENT-W-AGENT.md（法语）。

已安装 ffmpeg → H.264 视频（自动检测 NVENC · VideoToolbox · libx264）。 没有 ffmpeg → JPEG 帧。无论哪种方式都能正常工作。

示例

examples/ 中有三个可直接复制粘贴的场景，每个场景都包含 准确的提示词、实时视图中的内容，以及你可以介入的时机：

• 部署后 QA — 绕过缓存重新加载，点击完成整个流程，读取 console_errors 和 network_requests，并生成报告。包含一段 CLAUDE.md 代码片段，可在每次部署后运行。
• 需审批的购买 — Claude 填写结账信息，ask_approval 会在点击“Place order”之前暂停，你可以在手机上点按“Approve”。
• 登录接管 — Claude 遇到登录或 2FA 验证拦截，切换到 Manual，你在自己的设备上输入，Claude 永远不会看到 按键内容。

实时视图中的功能

• Claude 的光标滑向每个目标，点击时出现涟漪，显示操作标签 — 还有带时间戳的操作日志。
• 自动 | 手动切换。在手动模式下，鼠标、键盘、触控板滚动和 捏合操作都会转发；你输入时，Claude 的感知会暂停。
• 无需接管控制即可暂停 Claude。
• Claude 调用 ask_approval 时显示审批卡片。
• 指向事物（自动模式下轻点 → “William 指向：按钮 « Login »”） 并从页面上给 Claude 发消息。消息会在 Claude 下一个工具结果末尾传给 Claude — 或者，如果你使用 --dangerously-load-development-channels server:ridealong 启动 Claude，也可以通过 Claude Code 通道即时传递 （还会转发“已接管控制”/“已暂停”消息）。
• 真实标签页：标签栏与 Chrome 同步；轻点标签即可更改 Claude 的目标。
• 分辨率选择器（720p → 2K），更改会实时应用并保存。
• 支持捕获、全屏、视频/JPEG 切换，自动重新连接，适配手机。

工具

感知	操作	标签页	实时视图
state snapshot find read	navigate reload act fill scroll	tabs_list tabs_open tabs_select tabs_close	live_start live_mode live_stop
diff screenshot console_errors			ask_approval inbox
network_requests fetch_with_session

所有操作都针对同一个目标标签页。元素带有来自 snapshot/find 的稳定 [ref]，因此 Claude 按引用操作，而不依赖脆弱的选择器。 Chrome 的 HTTP 缓存和 service worker 会被绕过：Claude 看到的就是你刚部署的网站。

工作原理

Claude Code ──stdio──▶ ridealong (MCP) ──CDP──▶ Google Chrome
                          │
                          └─ live view ── ws ──▶ your browser / phone
                              JPEG frames, or CDP screencast → ffmpeg (GPU) → fMP4 → MSE
                              input relay ◀── Manual mode (never stored)

一台 Chrome 上运行两个 Claude Code 会话？第二个会话会作为控制客户端跟随第一个会话，并在第一个会话退出后接管。本地中继 （scripts/ridealong-mcp-relay.mjs）会在 SSH 连接断开后通过重放握手，保持 MCP 会话运行。

安全保障

• 不捕获。 手动模式下的输入会直接转发给 Chrome，绝不会被保留；在你控制时，感知工具会拒绝运行；快照中不会暴露密码字段的值。测试套件对此进行了严格验证。
• 签名的限时链接（HMAC，有效期为 30 s – 1 h）。设备令牌（有效期 30 天）仅保存在你的浏览器中。轮换 RIDEALONG_LIVE_SECRET 即可撤销所有令牌。
• 默认仅监听本机回环地址。 实时视图监听 127.0.0.1；是否对外开放由你决定。

路线图

• 会话录制（视频 + 按章节划分的日志）
• 为较弱的移动网络连接提供自适应比特率
• 配置文件：每个客户端 / 任务使用一个 Chrome 上下文，并支持无痕模式
• 带注释的屏幕截图（在图像上绘制引用标记）
• npx ridealong-mcp

参与贡献

欢迎提交问题和 PR——请参阅 CONTRIBUTING.md。 npm test 会针对真实的 Chromium 运行 131 个测试（并在可用时使用 ffmpeg）。

_{由 W Automatisations 构建 · Montréal · MIT}