aindeev/agent-chrome-relay

选用指南

AI 根据 README 整理 · 2026/10/11 14:06:22

使用方式

通过命令行使用，提供 setup、url、doctor、audit 等子命令。

查看 README 依据

- **Relay** (`relay/relay.mjs`): a DevTools endpoint per agent. Each agent sees and controls only the tabs it opened; commands that could raise or focus the browser are swallowed. - **CLI** (`bin/chrome-relay`): setup, the connection URL, diagnostics, audit trail. ## Setup (once per Mac, ~2 minutes) Fastest: paste [this prompt](https://agent-chrome-relay.aindeev.com/setup-prompt.txt) into Claude Code, Codex or Cursor and let your agent do it. By hand: Needs macOS, Google Chrome, Node.js 20+ and [`agent-browser`](https://github.com/vercel-labs/agent-browser) (`npm i -g agent-browser`).

```bash git clone https://github.com/aindeev/agent-chrome-relay cd agent-chrome-relay bin/chrome-relay setup # secret, background service, identities, `chrome-relay` on PATH, Claude Code skill ``` Then, **in each Chrome profile agents should use**: open `chrome://extensions`, turn on **Developer mode**, **Load unpacked**, and pick the `extension` folder of your clone. Check with `chrome-relay doctor`. After `git pull`: `chrome-relay update` (restarts the relay, reloads the extension in every profile). To remove: `chrome-relay uninstall`, then remove the extension in each profile.

部署要求

需要 macOS、Google Chrome、Node.js 20+ 和 agent-browser。

查看 README 依据

- **Relay** (`relay/relay.mjs`): a DevTools endpoint per agent. Each agent sees and controls only the tabs it opened; commands that could raise or focus the browser are swallowed. - **CLI** (`bin/chrome-relay`): setup, the connection URL, diagnostics, audit trail. ## Setup (once per Mac, ~2 minutes) Fastest: paste [this prompt](https://agent-chrome-relay.aindeev.com/setup-prompt.txt) into Claude Code, Codex or Cursor and let your agent do it. By hand: Needs macOS, Google Chrome, Node.js 20+ and [`agent-browser`](https://github.com/vercel-labs/agent-browser) (`npm i -g agent-browser`).

已知限制

仅支持 macOS，且需要用户手动设置；不适用于已登录账户之外的密码、passkey 或两步验证场景。

查看 README 依据

Lets your coding agents (Claude Code, Codex, Cursor, Paseo) use **your everyday Chrome**, with your real logins, from the command line, **in background tabs**: nothing takes focus, no dialogs, ~0.15s per command. ```bash agent-browser --cdp "$(chrome-relay url you@company.com)" open https://app.example.com/ agent-browser snapshot -i # the page's buttons, links and fields, each with a ref like @e5 agent-browser click @e5 agent-browser close ``` It's opt-in: nothing installs the extension for you, and it only runs on Macs whose owner set it up. ## How it works ```

1Password's frame on the page). A password, passkey, 2-step screen or signed-out account stops the hop, and the agent gets `SIGN-IN NEEDED: ...` and asks you to sign in in your own window. Which Google account a site uses comes from `~/.chrome-relay/identities.json` (`chrome-relay identities`): your Chrome profiles (filled in by setup), optional hand-set `sites.rules`, and `sites.learned`, which the relay fills in after each successful hop. Default: the profile's own account. ## Audit trail