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.
TypeScript agentic-browseragentic-browsingagy-cliaiai-agentai-browser-extensionai-toolsbrave-extensionbrowser-agentbrowser-automationbrowser-extensionbrowser-usebrowserskillchrome-extensionclaude-codecodexfirefox-addonmcp-servernanobrowserweb-automation
docs: show which browsers and agents Browsentic works with, and say where Windows and Linux stand
Shahriar7ffcd1d41bbd
diff --git a/README.md b/README.mdindex 944ad8f..55d0d08 100644--- a/README.md+++ b/README.md@@ -1,4 +1,4 @@-+# Browsentic – a completely integrated agentic browser extension@@ -8,7 +8,24 @@[](https://nodejs.org)[](LICENSE)-Hand your real, logged-in browser to the AI agent you already run. Browsentic is a browser extension with an AI side panel, plus a small local daemon: open the panel beside any tab, say what you want and it drives the page, ask a question and it reads the page and answers. It runs on [Claude Code](https://claude.com/claude-code), [Codex](https://developers.openai.com/codex/cli), [Antigravity](https://antigravity.google/docs/cli/install) or [Mistral Vibe](https://github.com/mistralai/mistral-vibe) (beta) — whichever you already have logged in — and doubles as an [MCP server](docs/guide/mcp-clients.md) so any MCP client can drive the same browser. No account, no API key, no cloud service.+Hand your real, logged-in browser to the AI agent you already run. Browsentic is a browser extension with an AI side panel, plus a small local daemon: open the panel beside any tab, say what you want and it drives the page, ask a question and it reads the page and answers. It runs on the agent CLI you already have logged in — five are supported — and doubles as an [MCP server](docs/guide/mcp-clients.md) so any MCP client can drive the same browser. No account, no API key, no cloud service.++<p>+ <strong>Works in</strong> + <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/chrome.svg" width="18" height="18" alt="Chrome"></a> Chrome · + <a href="docs/guide/install.md#firefox"><img src="https://browsentic.com/icons/firefox.svg" width="18" height="18" alt="Firefox"></a> Firefox · + <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/edge.svg" width="18" height="18" alt="Edge"></a> Edge · + <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/brave.svg" width="18" height="18" alt="Brave"></a> Brave · + <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/arc.svg" width="18" height="18" alt="Arc"></a> Arc+</p>+<p>+ <strong>Runs on</strong> + <img src="https://browsentic.com/icons/claude.svg" width="18" height="18" alt=""> <a href="https://claude.com/claude-code">Claude Code</a> · + <picture><source media="(prefers-color-scheme: dark)" srcset="https://browsentic.com/icons/openai-dark.svg"><img src="https://browsentic.com/icons/openai.svg" width="18" height="18" alt=""></picture> <a href="https://developers.openai.com/codex/cli">Codex</a> · + <img src="https://browsentic.com/icons/antigravity.svg" width="18" height="18" alt=""> <a href="https://antigravity.google/docs/cli/install">Antigravity</a> · + <img src="https://browsentic.com/icons/mistral.svg" width="18" height="18" alt=""> <a href="https://github.com/mistralai/mistral-vibe">Mistral Vibe</a> <sup>beta</sup> · + <picture><source media="(prefers-color-scheme: dark)" srcset="https://browsentic.com/icons/xai-dark.svg"><img src="https://browsentic.com/icons/xai.svg" width="18" height="18" alt=""></picture> <a href="https://docs.x.ai/build/overview">Grok Build</a> <sup>beta</sup>+</p>## Quick Start@@ -24,7 +41,7 @@ curl -fsSL https://browsentic.com/install.sh | shnpx browsentic setup```-Either way two steps are left, both inside the browser: **Load unpacked** `~/browsentic/extension/chrome-mv3` at `chrome://extensions`, then paste the pairing code into the Browsentic popup. On Firefox, run `npx browsentic setup --browser firefox` instead: it links the signed `.xpi` from the [release](https://github.com/imshaikot/browsentic/releases/latest), and there is no folder to load. You also need one agent CLI logged in — `claude`, `codex`, `agy` or `grok` (beta). Details, updating and building from source are in the [install guide](docs/guide/install.md).+Either way two steps are left, both inside the browser: **Load unpacked** `~/browsentic/extension/chrome-mv3` at `chrome://extensions`, then paste the pairing code into the Browsentic popup. On Firefox, run `npx browsentic setup --browser firefox` instead: it links the signed `.xpi` from the [release](https://github.com/imshaikot/browsentic/releases/latest), and there is no folder to load. You also need one agent CLI logged in — `claude`, `codex`, `agy`, `vibe` (beta) or `grok` (beta). Windows and Linux follow the same two steps; the folder is under your home directory there too. Details, updating and building from source are in the [install guide](docs/guide/install.md).## Key Capabilities@@ -43,14 +60,14 @@ Either way two steps are left, both inside the browser: **Load unpacked** `~/bro## How It Works-+<details><summary>The same flow, as text</summary>```You ──speak or type──> Extension ──local WebSocket──> Daemon ──spawns──> your agent CLI- ▲ (claude │ codex │ agy)+ ▲ (claude │ codex │ agy │ vibe │ grok)└──────────────── page actions ─────────────────────┘Any MCP client ──stdio──> browsentic mcp ──> the same daemon ──> the same browserdiff --git a/docs/guide/install.md b/docs/guide/install.mdindex d172efc..60f0a1a 100644--- a/docs/guide/install.md+++ b/docs/guide/install.md@@ -13,7 +13,8 @@ AI agent you already run locally.| | Requirement | Check || --- | --- | --- || **Node** | 20 or newer | `node --version` |-| **Browser** | Chrome, or another Chromium browser (Edge, Brave, Arc) | — |+| **Browser** | Chrome or another Chromium browser (Edge, Brave, Arc), or Firefox 140 or newer | — |+| **System** | macOS, Windows or Linux. macOS also has an [app](mac-app.md) | — || **Agent** | One of [Claude Code](https://claude.com/claude-code), [Codex](https://developers.openai.com/codex/cli), [Antigravity](https://antigravity.google/docs/cli/install), [Mistral Vibe](https://github.com/mistralai/mistral-vibe) (beta) or [Grok Build](https://docs.x.ai/build/overview) (beta) on your `PATH`, logged in | `claude --version`, `codex --version`, `agy --version`, `vibe --version`, `grok --version` |Two things worth knowing before you start:@@ -49,7 +50,8 @@ Two steps are left. Both happen inside the browser, so only you can do them.**1. Load the extension.** Open `chrome://extensions`, turn on **Developer mode** (top right),press **Load unpacked**, and choose the folder the command printed. On macOS you can press ⇧⌘G in-the folder picker and paste the path.+the folder picker and paste the path; on Linux, Ctrl+L. On Windows the folder is+`%USERPROFILE%\browsentic\extension\chrome-mv3`. Using Firefox instead? Skip to [Firefox](#firefox).Pin Browsentic to the toolbar so the popup is one click away.diff --git a/docs/guide/limits.md b/docs/guide/limits.mdindex 33e4d81..30040f2 100644--- a/docs/guide/limits.md+++ b/docs/guide/limits.md@@ -66,12 +66,27 @@ contains it with whatever levers that CLI offers, and they are not equal:| Claude Code | A per-run tool allowlist plus an explicit deny list — the strongest of them || Codex | No per-run tool list; the read-only sandbox is the whole containment, so it can still read any file you can || Antigravity | No tool list and no sandbox flag; its built-in tools are governed by your own CLI settings |+| Mistral Vibe (beta) | A per-run tool allowlist; its shell and file tools are never loaded, and every browser tool is granted by name || Grok Build (beta) | A per-run tool list, approvals that refuse anything not granted up front, and a sandbox that keeps its writes in its own folder; MCP servers you set up in Grok itself still load |The environment is sealed for all of them — cloud keys, registry tokens and database URLs inheritedfrom your shell are removed before the spawn, keeping only what that agent needs to authenticate.Details in [internals/guardrails.md](../internals/guardrails.md#spawn-containment).+## Two of the agents are beta++Mistral Vibe and Grok Build were built by reading each CLI and checking every flag, the containment+and the error texts against the real binary — but neither has carried a whole conversation end to+end yet, so the popup, the docs and the release notes say *beta*. What that means in practice:++- a run that fails says why, with the command that fixes it, rather than hanging;+- Vibe's replies arrive a message at a time rather than typed out, and it reports no token counts;+- a free Grok account is rate-limited, and Grok retries quietly for minutes before it gives up;+- the other three agents are untouched: the hooks the two share are covered by the spawn and+ drive tests.++[Choosing an agent](agents.md) has the per-agent detail. Please report what you find.+## MCP clients cannot answer a promptAnything the policy would confirm resolves to **deny** for an external MCP client, because there is