Xtaff home / Xtaff Browser

Browser bridge for AI coding agents

Your agent works in the browser you are already in.

Xtaff Browser connects Claude Code, Codex, Cursor or any other MCP client to your real Chrome — your tabs, your sessions, your logins — and asks you before an agent touches a new site.

Get it on the Chrome Web Store Install the local host npm package

Desktop Chrome 125+ and Node.js 22+. macOS has been tested; Linux and Windows have not yet been verified.

Current release
0.7.3 (2026-11-20)
Tools exposed
41
Transport
stdio, or HTTP mode for remote use
Runs in
Your Chrome, through an MV3 extension and a native host
Cloud relay
None — the extension does not connect to a Xtaff service

The problem: agents cannot see your browser

A coding agent can read your files and run commands, but the page you are looking at — the logged-in admin panel, the internal tool, the checkout you are debugging — is outside its reach. The usual workarounds each cost something:

RouteUses your current loginsStarts another browserMain cost
Playwright / Puppeteer with its own browserNo — fresh profileYesYou log in again; SSO and MFA usually stop it
Attach over the DevTools protocolPartlyNoSince Chrome 136, the default profile refuses --remote-debugging-port
Cloud browserNoRemotePages leave your machine; intranet systems are unreachable
Extension + local host (Xtaff Browser)YesNoRegister a local host once; Chrome 125+

How it works

  1. The extension executes. It runs inside your Chrome, owns a tab group, and performs clicks, typing, navigation and reads only after the origin is approved.
  2. The host connects. A small native host on your machine bridges the extension to the MCP server over native messaging. It is registered once with xtaff-browser-host.
  3. The server exposes tools. xtaff-browser-mcp gives the agent 41 tools over stdio or HTTP, and returns screenshots, page structure, network records and script results.

What it adds beyond a plain bridge

One tab group per MCP connection

Each connection gets its own Xtaff·<name> group. Tab IDs, element refs, batches, scripts, uploads, downloads, sessions and takeovers from another group are rejected at the extension, not merely filtered in the server. You can stop one agent by group and keep the others running.

Per-site approval by default

A site the agent has not been granted opens as a blank tab with a prompt. Nothing loads until you allow that origin. Stopping, taking over and resuming are all in the popup, with a badge and a desktop notification when the agent is waiting.

Site playbooks, including your own walkthroughs

An agent can save how a site behaves and other local agents can search that knowledge later. You can also record a walkthrough in the popup; the draft covers HTTP/HTTPS pages, up to 20 steps, and does not store typed text or sensitive field values until you review and publish it.

Saved sessions and account switching

Capture the cookies and localStorage of a signed-in tab as a named profile, then apply it to switch accounts. Credentials stay in the session store; the model context only sees the profile name and the resulting page.

Remote use over HTTP and a tunnel

Run the server in HTTP mode behind your own tunnel to drive a browser on another machine — for example, the always-on office computer from home. HTTP mode has no TLS of its own and is meant for loopback or a tunnel, never a public port.

Also in the 41 tools: batched steps (up to 50), a restricted scripting tool for loops and branches, console and network inspection with redacted bodies, screenshots with password masking, file upload up to 10 MB and download capture, and explicit human takeover with human_required.

Boundaries — what it does not do

Frequently asked

What is Xtaff Browser?

Xtaff Browser is a Chrome extension plus a local MCP host. It lets an AI coding agent use the Chrome you are already signed in to, with per-site approval, instead of starting a separate browser.

How is it different from Playwright MCP or Chrome DevTools MCP?

Playwright MCP starts its own browser with a fresh profile, so your logins do not carry over. Chrome DevTools MCP attaches over the DevTools protocol, and since Chrome 136 the default profile refuses --remote-debugging-port. Xtaff Browser runs inside your existing Chrome through an extension and a local host.

Does my browsing data go to Xtaff?

No. The extension talks to a native host on your machine, not to a Xtaff service. What the agent reads is sent by your MCP client to the model provider configured there.

Can several agents use the same browser at once?

Yes. Each MCP connection gets its own tab group titled Xtaff·<name>, and tools in one group cannot see or act on tabs in another. Site approvals, logins and browser memory stay shared.

Which MCP clients are supported?

Any client that can run a local stdio server, such as Claude Code, Codex, Cursor or Zed. An HTTP mode is available for clients that connect over HTTP.

Does it work on Windows or Linux?

Not verified yet. The extension, host and server are built for desktop Chrome on macOS, Windows and Linux, but only macOS has been tested so far.

Can it operate an intranet system that needs a login?

Yes, as long as the site opens in your Chrome. Sign-in, CAPTCHA and MFA are handed back to you and the agent waits, then continues.

How do I uninstall it?

Run xtaff-browser-host --uninstall, then npm uninstall --global @xtaff/browser-mcp, and remove the extension from Chrome. See the install guide.


中文说明

Xtaff Browser 是 Chrome 扩展 + 本机 MCP 宿主。它让 Claude Code、Codex、Cursor 等 AI 编程助手在你当前已登录的 Chrome 里操作网页:用你现成的标签页和登录态,默认按站点授权,而不是另起一个干净的浏览器。

和另外三条路线比

路线用现有登录态另起浏览器主要代价
Playwright / Puppeteer 自建浏览器否(默认新 profile)是要重新登录,SSO / MFA 通常过不去
CDP 附加调试端口部分否Chrome 136 起默认 profile 不允许 --remote-debugging-port
云端浏览器否远程页面离开本机,内网系统进不去
扩展 + 本机宿主(Xtaff 走这条)是否注册一次本机宿主;需要 Chrome 125+

在普通桥接之外

边界

不是 CI 并行自动化工具(那边用 Playwright);不做云端中转,也没有托管浏览器;仅桌面版 Chrome,不支持 Firefox / Safari / 安卓版 Chrome;登录、验证码、MFA、支付等仍由你本人完成;Agent 读到的内容会由它自己的 MCP 客户端发往所配置的模型服务。

常见问题

Xtaff Browser 是什么?
Xtaff Browser 是 Chrome 扩展 + 本机 MCP 宿主,让 AI 编程助手在你当前已登录的 Chrome 里操作网页,默认按站点授权,而不是另起一个干净的浏览器。

和 Playwright MCP、Chrome DevTools MCP 有什么区别?
Playwright 类方案另起浏览器、用新 profile,登录态带不过去;CDP 附加受 Chrome 136 起「默认 profile 不允许调试端口」的限制。Xtaff 通过扩展 + 本机宿主直接在你现有 Chrome 里执行。

支持 Windows 和 Linux 吗?
尚未验证。扩展、宿主和服务端按 macOS / Windows / Linux 桌面版 Chrome 设计,目前只实测了 macOS。

怎么卸载?
先运行 xtaff-browser-host --uninstall,再运行 npm uninstall --global @xtaff/browser-mcp,最后在 Chrome 里移除扩展。