MCP server · v0.6 · macOS
browserexec

Run your agent's commands in the browser you already have open.

Your profile, your tabs, your logins. Claude Code, Codex and Cursor can click through a page and read its console, network and storage, like you would in DevTools.

scuffmark: bx
claude · bx · Brave (Personal)0.0s
  1. Place order does nothing on staging. Reproduce it and find the root cause.
  2. start "Debug Place order on staging"pointer: Working on: Debug Place order…
  3. open 127.0.0.1:8765 profile=Personal"Checkout · Acme Store" · signed in
  4. snapshote25 button "Place order"
  5. click e25navigated: false
  6. consoleTypeError: Cannot read properties of undefined (reading 'toFixed') :60
  7. networkPOST /api/checkout 500
  8. network request=n2{"error": "coupon SAVE10 expired"}
  9. done "Reproduced Place order failure; found root cause"
  10. The API rejects the expired SAVE10 coupon with a 500. The handler never checks r.ok, so data.total is undefined and it throws at line 60.
real run, replayed at 4x32.8s · 12 bx calls
// bx = browser exec

Like docker exec, but the container is your browser.

docker exec runs a command inside a container that's already running. bx does the same for the browser you already have open. It doesn't launch a clean headless copy. It attaches to your Brave or Chrome, picks the profile you name, and runs the agent's commands there.

A container that's already running
# run a command inside it
docker exec -it api sh

Same filesystem, same env, same state as the running process.

The browser you already have open
# the agent calls bx tools
open  staging.acme.dev  profile=Work
click e25
network --errors

Same cookies, same sessions, same SSO as your own tabs. Nothing to log in to again.

Your agent

calls bx as an MCP server

Claude CodeCodexCursor
MCP

bx

holds one DevTools connection per browser, shared by every session. You click Allow once.

DevTools

Your browser

the profile you name, signed in

BraveChromeEdgeArc
// demo

A silent checkout bug, found in 33 seconds.

A real run: Claude with only the bx MCP, in Brave, on a demo store where Place order does nothing. The browser in the video is that run's recording, with bx's pointer; every call and result came from it.

33sprompt to root cause
12bx calls
0logins or test accounts
1Allow click, ever
// real runs

Everyday errands, recorded from real runs.

Each one is a single prompt to Claude with bx, recorded with bx record at human pace: the agent's real tool calls on the left, the browser with bx's pointer on the right. Pauses while the model thinks are shortened. Private data is blurred; nothing was sent, submitted or bought.

// use cases

For anything that needs you signed in.

A fresh headless browser can't get past your SSO. Your own profile already has.

clickconsolenetwork

Reproduce a bug behind a login

The agent does the steps in your session, then reads the exception with its file and line and the failing request's response body.

checkout fails on staging, find out why
emulateperformance

Test a page on a slow phone

390×844 on slow 3G with a 4× slower CPU, reloaded and measured: LCP, CLS, long tasks and the slowest resources, each rated.

how does the dashboard load on a phone on 3G?
storageeval

Inspect the app's state

Cookies, localStorage and sessionStorage for the current page, so "why am I logged out" or "which flag is on" gets a real answer.

which feature flags does my session have?
downloadpdf

Collect invoices and receipts

The agent opens each billing page in the profile you're signed in to, saves the invoices to a folder, and turns pages without a download into PDFs. If a site wants a billing address first, it asks you.

get last month's invoices into ~/Invoices
mockmouse

See the error states

Answer one API call with a 500 or an empty list and watch how the page copes, without touching the server. Charts, maps and canvases take clicks at a point.

what does the dashboard show when the orders API fails?
snapshotfillread

Work in consoles you're signed in to

Read a cloud console, fill a form, pull a report. bx tells the agent to ask you before it submits, sends, buys or deletes.

list the failing jobs in our CI dashboard
// watch or fast

Watch it work, or let it run.

bx has two modes. Both use the same browser, profiles and logins, run at full speed, and send real mouse and keyboard events, which a page can't tell from yours. In both, a pointer tagged "bx" shows where it's acting and says what it's doing, or that it's waiting for the agent.

Default

Fast mode mode fast

  • The browser stays where it is, so you keep working.
  • The pointer jumps to each element and says what it's doing.
  • Each step runs as soon as the page settles.
8sfor a 32-step form
To see it work

Watch mode mode watch

  • The tab bx works in comes to the front.
  • It follows bx from tab to tab and profile to profile.
  • Still full speed. Ask for human pace and the pointer glides with the real mouse, steps pause, and dropdowns open to the choice.
50sfor the same form, at human pace
A signup form in the browser. bx's pointer sits on the Name field with a tag that reads: bx 7/32 · Fill Name.
Human pace, step 7 of a 32-step batch. Screenshots and snapshots leave the pointer out.

Just ask your agent. "Show me", "do it in the background", "at human pace": the agent sets the mode and pace for that task through bx's start tool. Nothing to configure.

SettingWhat bx does when the agent doesn't say
modefast (default) leaves the browser where it is; watch brings it to the front.
pacefull (default) or human, in either mode.
typingpaste (default) puts text in at once, as a paste does. keys types key by key, for the rare site that reacts only to key presses.

Change a default with bx config set mode watch, or ask your agent to. The CLI and every MCP app read the same settings. BX_MODE, BX_PACE and BX_TYPING override them for one process, and what an agent asks for in start wins for its task.

// compared

Fewer calls on multi-step forms.

On a 6-step vendor onboarding form (a shadow-DOM bank form, a PDF upload, an approval), the same agent needed a median of 24 tool calls with bx against 62 with Playwright MCP: batch fills a whole step in one call. All runs of both finished the task.

bxPlaywright MCPChrome DevTools MCP
MCP server memory29 MB (about 95 MB started through npx)251 MB290 MB
Your logged-in browserYes: the profile you name, one Allow clickThrough a browser extension, or a browser started with a debugging portThrough remote debugging on Chrome 144+
Browser downloadNone: uses the Chromium browser you haveNone if Chrome or Edge is installedNone, needs Chrome
A small benchmark, run by us. We wrote the test pages and tuned bx after the first round, with three runs per tool on one Mac. On a keyboard-only spreadsheet the two came out even, and Playwright MCP has things bx doesn't, such as cross-browser and headless runs. Method, every run, where bx lost and the caveats: docs/benchmark.md.
// history

Ask what it did. Get the whole session.

bx logs every action on your machine, one file per agent session. Inside Claude Code or Codex that's the app's own conversation, so you can jump back to it. Ask your agent "what did bx do in my last session?" and it calls history, which draws the session from start to end: each task, the pages it worked on, and every action with its result.

bx-4c1e9a07d2f3  claude-code  bx  Nov 14 13:00:29-13:01:02  "Read example.com"  4 actions, 2 failed
resume: claude --resume 1b6e2c90-5a4d-4f1e-9c3b-7d8a2e6f0b14
├─ "Read example.com"  13:00:29-13:00:32  3 actions, 1 failed  done: "Followed the link"
│  ├─ Personal  example.com/
│  │  ├─ 13:00:29  open https://example.com  ok 413ms
│  │  └─ 13:00:29  click a  ok 364ms  -> iana.org/help/example-domains
│  └─ Personal  iana.org/help/example-domains
│     └─ 13:00:30  fill #nope  FAILED: no visible element matches "#nope"
└─ (untitled)  13:00:32-13:01:02  1 action
   └─ Personal  iana.org/help/example-domains
      └─ 13:00:32  goto back  ok 236ms  -> example.com/
What's logged
LoggedTime, browser, profile, the page it acted on and where it led, the action and its target, the result and how long it took.
Left outWhat was typed, and what links carry. A fill shows the field, never the value; typed text and scripts show only their length. URLs are logged without the part after ?, where sign-in codes and reset tokens travel, and without a # part holding tokens such as #access_token=. bx config set log.values full logs values for debugging, off logs nothing. Only you can change this, never the agent.
WhereOnly on your Mac, readable only by you. Nothing is sent anywhere.
Pin it"Pin that as Onboard vendor" saves the task. Later, "do the Onboard vendor pin for Lumen" and the agent follows its steps page by page, asking you only for the values. Elements are logged by name, button "Next", so the steps still make sense next month. Pins are never deleted.
How long it's kept
Why size, not ageOne action is about 285 bytes. An agent doing 2,000 actions a day writes about 210 MB a year, so 2 GB lasts around ten years. An age limit would only throw history away, so logs are kept until they get big, not until they get old.
RecentPlain files, up to 2 GB in total, about 7.5 million actions.
OlderPast 2 GB, the oldest sessions are gzipped, about ten times smaller, up to 5 GB. history reads them as they are.
ExpiryPast the 5 GB, the oldest archived sessions are deleted. That only stops a runaway agent from filling the disk.
Change itbx config set log.days 90 makes history expire; log.max and log.archive_max take sizes. Agents can raise these, only you can lower them.
// setup

Three steps, once per browser.

Install the plugin

Claude Code and Codex: the command at the top. It brings the MCP server and the skill, and updates with the plugin manager. Claude Desktop and Cursor: run npx -y @facets-cloud/bx mcp install. Any other MCP app: npx -y @facets-cloud/bx mcp.

Turn on remote debugging

It's off by default. Open this page in your browser and switch it on.

Bravebrave://inspect
Chrome, Arcchrome://inspect
Edgeedge://inspect
Vivaldivivaldi://inspect

Click Allow, once

The browser asks before bx connects. bx keeps that connection in a small background process, so every session and app shares it until the browser quits.

macOS 27 and later: give the app that runs the server Full Disk Access (your terminal, or Claude Desktop or Cursor). bx reads DevToolsActivePort and Local State in the browser's folder, and macOS 27 blocks that otherwise. Rather not? The launch tool starts a separate copy of the browser that needs neither Full Disk Access nor the Allow click.
// 39 tools

Everything you'd do by hand, plus DevTools.

The agent snapshots a tab and gets a ref like e12 for each element, or names one the way the snapshot shows it: button "Next". Actions report what changed on the page, and batch runs a whole plan in one call, across screens it hasn't seen yet.

Setup 5

  • doctor
  • list_browsers
  • setup
  • launch
  • settings

Read 9

  • list_profiles
  • list_tabs
  • snapshot
  • read
  • screenshot
  • eval
  • wait
  • history
  • pins

Act 17

  • open
  • goto
  • click
  • hover
  • drag
  • fill
  • type
  • key
  • upload
  • download
  • pdf
  • mouse
  • dialog
  • close_tab
  • batch
  • start
  • done

Debug 8

  • console
  • network
  • storage
  • change_storage
  • mock
  • performance
  • emulate
  • cdp
// before you install

It acts as you. Plan for that.

Your session is the point

The agent can read any page and act on any site you're signed in to in that profile. Asking before risky actions is its judgment, not a hard limit.

Fence it with a profile

Point it at a separate profile, or the launch browser with its own logins, for anything it shouldn't touch.

See what it does

A "bx" pointer shows every action as it happens. Say "show me" and the tab bx works in comes to the front; ask for human pace to slow it down.

browser exec

One command to add it, or paste one prompt into your agent and let it set bx up.