Skip to content

Why BrowserMesh

Most single-browser automation assumes one active page. That assumption becomes fragile when an external client coordinates several users, accounts, roles, or independent tasks.

BrowserMesh replaces ambient state with explicit identity:

ConcernBrowserMesh model
Browser identityone session, one isolated Chromium context
Page identitypageId, owned by exactly one session
Targetingevery page call supplies sessionId and pageId
Orderingone serial queue per session
Parallelismindependent queues for independent sessions
Reasoningperformed by the external MCP client

Not just another Playwright MCP wrapper

BrowserMesh's domain and runtime do not depend on Playwright or MCP types. The Playwright adapter owns browser-engine handles; the MCP adapter owns transport and schemas. Neither adapter is the product model.

This separation matters because isolation, ownership checks, deadlines, queue recovery, persistence ordering, and error contracts remain BrowserMesh behavior—not accidental behavior inherited from an upstream tool.

When to create another session

Create a separate session for a different user, account, role, authentication state, or independent parallel workflow. Create another page in the same session only when it should share that session's cookies and storage.

Released under the Apache License 2.0.