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: show which browsers and agents Browsentic works with, and say where Windows and Linux stand

Shahriar7ffcd1d41bbd
diff --git a/README.md b/README.md
index 944ad8f..55d0d08 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-![Browsentic: your browser's superpower, free and open source](docs/assets/social-card.png?v=0.4.11)
+![Browsentic: your browser's superpower, free and open source](docs/assets/social-card.png?v=0.7.0)
# Browsentic – a completely integrated agentic browser extension
@@ -8,7 +8,24 @@
[![node](https://img.shields.io/node/v/browsentic)](https://nodejs.org)
[![license](https://img.shields.io/npm/l/browsentic)](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>&ensp;
+ <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/chrome.svg" width="18" height="18" alt="Chrome"></a>&nbsp;Chrome&ensp;·&ensp;
+ <a href="docs/guide/install.md#firefox"><img src="https://browsentic.com/icons/firefox.svg" width="18" height="18" alt="Firefox"></a>&nbsp;Firefox&ensp;·&ensp;
+ <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/edge.svg" width="18" height="18" alt="Edge"></a>&nbsp;Edge&ensp;·&ensp;
+ <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/brave.svg" width="18" height="18" alt="Brave"></a>&nbsp;Brave&ensp;·&ensp;
+ <a href="docs/guide/install.md"><img src="https://browsentic.com/icons/arc.svg" width="18" height="18" alt="Arc"></a>&nbsp;Arc
+</p>
+<p>
+ <strong>Runs on</strong>&ensp;
+ <img src="https://browsentic.com/icons/claude.svg" width="18" height="18" alt="">&nbsp;<a href="https://claude.com/claude-code">Claude Code</a>&ensp;·&ensp;
+ <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>&nbsp;<a href="https://developers.openai.com/codex/cli">Codex</a>&ensp;·&ensp;
+ <img src="https://browsentic.com/icons/antigravity.svg" width="18" height="18" alt="">&nbsp;<a href="https://antigravity.google/docs/cli/install">Antigravity</a>&ensp;·&ensp;
+ <img src="https://browsentic.com/icons/mistral.svg" width="18" height="18" alt="">&nbsp;<a href="https://github.com/mistralai/mistral-vibe">Mistral Vibe</a> <sup>beta</sup>&ensp;·&ensp;
+ <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>&nbsp;<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 | sh
npx 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
-![How an instruction becomes a click](https://raw.githubusercontent.com/imshaikot/browsentic/website/public/flow.png)
+![How an instruction becomes a click](https://browsentic.com/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)
+ ▲ (claude │ codex │ agy │ vibe │ grok)
└──────────────── page actions ─────────────────────┘
Any MCP client ──stdio──> browsentic mcp ──> the same daemon ──> the same browser
diff --git a/docs/guide/install.md b/docs/guide/install.md
index 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.md
index 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 inherited
from 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 prompt
Anything the policy would confirm resolves to **deny** for an external MCP client, because there is