CLI · bmc

From terminal to live feed in one command

Une commande. Le trafic de Chrome atterrit dans le même flux en direct — aucun certificat à installer.

A terminal window running "bmc start" that reports Chrome attached and capture live; the prompt line extends as a dashed stream into a mini dashboard card with green status codes. Two Chrome browser devices sit behind the terminal, and a BusyBro chat exchange with a confirm check fills its lower half. $ bmc start ✓ chrome attached · capture live live 200 201
Installer et capturer · macOS / Linux
bash
# macOS / Linux (self-updates from the dashboard):
curl -fsSL https://cdp.busymate.net/install.sh | bash

# Sign in once, create a browser, and capture it → your Busymate feed:
bmc login
bmc create dev --browser chrome --start
Installer et capturer · Windows
powershell
# Windows (PowerShell) — same, self-updating:
irm https://cdp.busymate.net/install.ps1 | iex

bmc login
bmc create dev --browser chrome --start

Pourquoi bmc

The simplest capture source

Le chemin le plus rapide entre « ouvrir Chrome » et « inspecter chaque requête » — et il peut aussi façonner ce trafic.

Zéro configuration de confiance — littéralement aucune

Comme bmc lit le DevTools Protocol, le trafic est déjà déchiffré. Rien n’entre dans un trousseau, rien ne déclenche d’avertissement ; la capture démarre en même temps que Chrome.

Des navigateurs comme appareils nommés

Un démon en arrière-plan gère des profils Chrome indépendants comme appareils nommés — démarrez, arrêtez et scriptez chacun depuis le terminal, le tableau de bord ou un appel MCP. Vos navigateurs rejoignent la flotte.

Simuler et muter, en local

Le même moteur JS isolé qui anime le proxy tourne contre votre vraie session Chrome : réécrivez des requêtes, synthétisez des réponses et regardez chaque changement atterrir visiblement dans le flux.

BusyBro dans votre terminal

Un chat REPL au scrollback natif qui connaît les appareils de cette machine. Demandez-lui de créer un navigateur, d’ouvrir une URL, de lancer une vérification — les actions exigent confirmation, et les réponses s’appuient sur votre capture réelle.

N’y touchez plus jamais

Le démon se met à jour tout seul quand il est inactif, annonce son build en direct et redémarre à la demande depuis le tableau de bord ou MCP. C’est une infrastructure qui s’entretient elle-même.

How it works

Reads Chrome traffic after TLS

bmc attaches to Chrome over the DevTools Protocol — the same wire DevTools itself uses — so it sees requests exactly as the browser does: already decrypted.

Chemin des données : TLS se termine dans Chrome ; bmc lit les événements DevTools Protocol déjà déchiffrés et transmet les entrées à l'API d'ingestion Busymate, jusqu'au dashboard, à MCP et à l'export HAR. chrome --remote-debugging TLS se termine ici GET api.example.com 200 POST auth.example.com 201 GET cdn.example.com 304 ws:// Network.* déjà déchiffré bmc entrées + corps source: cdp POST /ingest dash.busymate.dev · flux en direct mcp.busymate.dev · browser_* export_har · mêmes entrées
  1. 01

    Its own Chrome, per folder

    bmc start launches a dedicated Chrome with its own profile and its own debug port for the current directory. Each folder is an independent device — run it in two folders and you get two fully separate browsers.

  2. 02

    Attach over the DevTools Protocol

    It connects to Chrome's debug port over a WebSocket, auto-attaches to every tab, and enables the Network domain — the same wire Chrome DevTools itself uses. No extension, no proxy in the path, nothing injected into pages.

  3. 03

    Events become entries

    Request, response and timing events are correlated into the same entry shape every Busymate source uses, with headers and bodies (up to 1 MB per body) pulled straight from the browser — after Chrome already decrypted them.

  4. 04

    Batched into one feed

    Entries are batched and posted to the ingest API about once a second. The folder pairs as a real Busymate device, so its traffic lands in the same dashboard, the same filters, the same MCP tools and the same HAR export as every phone.

No certificates

Capture without a root CA

TLS terminates inside Chrome, and bmc reads on the browser's side of it. There is no man-in-the-middle to trust — so there is nothing to install, and nothing for pinning to detect.

A proxy debugger decrypts HTTPS by re-signing it with its own certificate authority — which means installing that CA, trusting it in a keychain, and losing the apps that pin their certificates. bmc skips the whole problem: the DevTools Protocol hands over each request after Chrome has already decrypted it.

Capture paths compared: CDP, MITM proxy, on-device VPN
What it takesbmc (CDP)Proxy (MITM)iOS / Android app
Root CA to installNoneYes — trust the proxy CAYes — on-device CA, decrypting only domains you opt in
Network setupNonePoint each client at the proxyNone — an on-device VPN tunnel
Pinned certificatesUnaffected — nothing sits in the TLS pathPinned apps refuse the proxy CAPinned apps stay encrypted (metadata still visible)
What it seesThe Chrome it launches — every tabAny app or script you point at itEvery app on the phone
Best forWeb apps, SPAs, agent-driven browsingBackends, scripts, browsers on other machinesMobile apps, in the field

Each path is first-class: the proxy and the phone apps exist precisely for the traffic CDP can't see. Use bmc for browsers, the proxy for anything you can point at it, and the apps for whole-phone capture.

Browser automation

Drive the browser. See every request.

Every bmc browser is remote-controllable over MCP — an AI agent or a script can open pages, read them and act, while capture records every request the session makes. That combination is the point.

Drive and read the page

browser_open
Navigate the browser to a URL.
browser_targets
List the open tabs and pick the one to drive.
browser_snapshot
A compact accessibility-tree snapshot — the page as structured text, built for agents.
browser_screenshot
A PNG of the active page.
browser_eval
Run JavaScript in the page. Placeholder variables are resolved server-side from the device's env, so an agent can fill a login form without ever seeing the password.
browser_cdp
Raw DevTools Protocol access for everything else — owner-gated.

Browser profiles

Built-in Chrome, Brave and Edge profiles plus custom ones authored once in the dashboard — per-OS binaries, default flags and a flag catalog every machine's bmc resolves the same way.

  • list_browser_profiles
  • get_browser_profile
  • upsert_browser_profile
  • delete_browser_profile

The daemon, remotely

Live build, uptime and logs without SSH; list every named browser on a machine; restart or hot-update the daemon while running captures keep capturing. One switch arms or disarms it all, per device.

  • get_cdp_daemon_status
  • get_cdp_logs
  • list_cdp_instances
  • restart_cdp_daemon
  • update_cdp_daemon
  • set_device_cdp_control

Remote control is opt-in per device and permission-gated; capture keeps flowing either way.

GodBrowser

Une identité d'appareil cohérente, chaque requête capturée

GodBrowser est un Chromium anti-empreinte qui donne au navigateur une identité d'appareil cohérente et d'apparence réelle. C'est un profil de navigateur intégré à bmc — un agent peut donc exécuter une persona et capturer son trafic dans le même flux en direct que vos téléphones.

Sélectionnez GodBrowser avec un seul indicateur et bmc le pilote via le même DevTools Protocol que n'importe quel autre appareil de navigateur : il inspecte chaque requête émise par la persona — déjà déchiffrée, sans CA racine, sans proxy — et les transmet à votre flux Busymate. GodBrowser présente bmc comme son compagnon d'inspection des requêtes pour exactement cet appariement.

Une identité, d'un seul tenant

User-agent, écran, WebGL, canvas et audio, locale et fuseau horaire concordent tous avec la persona — et TLS/JA4, UA-CH et codecs s'alignent sur l'appareil revendiqué avant qu'une ligne de JavaScript ne s'exécute. Selon la formule de GodBrowser : un vrai appareil, pas un appareil déguisé.

Graines déterministes

L'indicateur --bot-profile dérive toute une identité d'appareil à partir d'une chaîne de graine. Changez la graine, changez l'appareil — répétable et reproductible, de sorte qu'une persona se rejoue à l'identique.

Des personas par plateforme et navigateur

Windows, macOS, Linux, iOS et Android croisés avec Chrome, Safari, Firefox, Samsung Internet et Edge, sélectionnés avec --bot-os et --bot-browser. La base est un Chromium 151 modifié.

Cluster, API et MCP

GodBrowser s'exécute sur votre propre cluster de nœuds, piloté depuis le code, son API ou un client IA — et fournit son propre serveur MCP distant. Les proxys sont attribués par profil de façon déterministe ; les sessions se synchronisent entre machines via Redis.

Exécutez une persona, capturez son trafic
bash
# GodBrowser is a built-in bmc browser profile — pick it per device:
bmc create ios-persona --browser godbrowser -- \
  --bot-os=ios --bot-browser=safari --bot-profile=seed-42 --start

GodBrowser est l'un des profils intégrés de bmc, aux côtés de Chrome, Brave et Edge — le sélectionner avec --browser godbrowser suffit à tout configurer. bmc résout le binaire, expose ses indicateurs de persona, appaire l'appareil comme un “God Browser” distinct et étiquette son trafic capturé en gdp pour qu'il ressorte dans le flux. Rien n'est injecté dans GodBrowser : bmc le pilote via le DevTools Protocol, et sa couche anti-empreinte réside dans le cœur du navigateur, elle reste donc intacte sous automatisation. Les deux outils sont nativement MCP — le serveur MCP distant de GodBrowser et celui de Busymate permettent à un même agent de piloter des personas et de lire leur trafic dans une seule session, chacun derrière son propre jeton fondé sur le consentement.

What people build

One tool, four jobs

Agent-driven QA

An assistant opens your staging site, walks the flow and screenshots what it sees — while the network feed shows exactly what broke, with full request and response bodies.

Debug a SPA

Watch XHR and fetch calls stream live with headers, bodies and timings while you click through the app. The history survives a reload — no DevTools-tab archaeology.

Capture an OAuth flow

Redirect chains, tokens and callbacks recorded end to end — including on providers whose pinned certificates a proxy can't open.

Work a signed-in page

The folder's Chrome profile keeps its session between runs; snapshot and eval read the page while capture documents every request behind it.

FAQ

The sceptical questions

Does bmc need a certificate or a proxy?

No. It attaches to Chrome over the DevTools Protocol and reads traffic after Chrome has decrypted it. There is no root CA to install, no keychain trust prompt, and no proxy settings to change.

Does it work with certificate pinning and HSTS?

Yes. Pinning defends the TLS connection between Chrome and the server — bmc never touches that connection; it reads inside the browser. HSTS, corporate device policy and managed keychains are equally unaffected.

Does it modify pages or the sites I visit?

Capture injects nothing — bmc listens to Chrome's own network events. It also launches its own Chrome with its own profile, so your everyday browser is never touched.

Can it run headless or in CI?

Yes. Anything after -- goes straight to Chrome (for example --headless=new), and CDP_USER_JWT or CDP_PAIR_EMAIL and CDP_PAIR_PASSWORD sign in without opening a browser.

Which browsers does it support?

Chromium-family browsers: built-in Chrome, Brave, Edge and Chromium profiles, plus custom profiles you author in the dashboard. Anything that speaks the DevTools Protocol.

What about traffic outside the browser?

bmc only sees the Chrome it is attached to. For backends and scripts use the Busymate proxy; for whole-phone capture use the iOS or Android app — everything lands in the same feed.

Start capturing Chrome

Installez bmc, connectez-vous une fois, et le trafic de Chrome atterrit dans le même flux en direct.

Ask your mate