Skip to content

Commit f6328ca

Browse files
committed
docs: clarify local-first positioning in README
Made-with: Cursor
1 parent c2069ef commit f6328ca

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

README.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,16 @@ An open-source framework for building site-specific MCP servers that operate ove
66

77
---
88

9+
## Why local sessions?
10+
11+
Most browser automation infrastructure works by running browsers in the cloud and asking you to re-authenticate there. That model works well for anonymous or company-owned accounts, but breaks down for personal ones — you wouldn't hand your LinkedIn, Gmail, or bank credentials to a third-party server.
12+
13+
browserkit takes the opposite approach: **your machine is already authenticated everywhere.** It reuses the sessions that exist on your laptop right now, runs all browsers locally, and never sends cookies or credentials over the network. The AI gets access to your real identity on the web; nothing leaves localhost.
14+
15+
The trade-off is intentional — browserkit is single-user and local-only by design. If you need a cloud fleet or multi-tenant access, this is not that tool.
16+
17+
---
18+
919
## Quick Start
1020

1121
```bash
@@ -288,7 +298,6 @@ Users add the package name to `browserkit.config.js` — no naming convention re
288298
See [ARCH.md](ARCH.md) for full architecture details.
289299
290300
Key properties:
291-
- **Local-first**: runs on your machine, no cloud required
292301
- **Session-persistent**: maintains auth across tool calls and process restarts
293302
- **Site-specific**: deterministic selector-based tools, not DOM-guessing agents
294303
- **MCP-native**: each adapter is a standard HTTP MCP server

0 commit comments

Comments
 (0)