Skip to content

An agentic browser harness: an AI side panel & orb in your own logged-in Chrome, Edge, Arc, Brave or even Firefox run by the agent/subscription you already use (Claude Code, Codex, Antigravity). Free, open source, no API key. Also an MCP server.

docs(readme): illustrate the how-it-works flow, keeping the text diagram

Shahriar5bbca50d4f1b
diff --git a/README.md b/README.md
index 2a12a1a..6547737 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,11 @@ You also need one agent CLI on your `PATH` and logged in — `claude`, `codex` o
## How It Works
+![How an instruction becomes a click](https://raw.githubusercontent.com/imshaikot/browsentic/website/public/flow.png)
+
+<details>
+<summary>The same flow, as text</summary>
+
```
You ──speak or type──> Extension ──local WebSocket──> Daemon ──spawns──> your agent CLI
▲ (claude │ codex │ agy)
@@ -48,6 +53,8 @@ You ──speak or type──> Extension ──local WebSocket──> Daemon ─
Any MCP client ──stdio──> browsentic-mcp ──> the same daemon ──> the same browser
```
+</details>
+
The extension dials out to the daemon, because a Manifest V3 service worker cannot listen for connections. One daemon owns the browser link, so several MCP clients can share one browser. Everything binds to `127.0.0.1`.
## Resources