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.

3.8 KB
Raw Blame

browsentic

This is Browsentic Bridge, the half of Browsentic that runs on your computer.

Browsentic is your browser's superpower: an agentic browser harness that runs the agent CLI you already use from a side panel in your real, logged-in browser. The side panel opens beside whatever tab you are on; the Bridge runs on loopback and starts your agent CLI when you give it work. It is free and open source, with no hosted relay, no API key, no account and no headless browser: the agent works in the tabs you are already signed in to.

Install

One command sets everything up, the extension included:

npx browsentic@latest setup

It starts Browsentic Bridge, asks which browser you use, opens the extension's store page there and waits for the browser to connect. Press Add to Chrome (Add in Firefox; Edge first asks you to allow extensions from other stores), and the extension connects by itself; if it asks for a code, enter the one setup prints. On macOS and Windows an app does the same from a window: see browsentic.com/install.

The extension is on the Chrome Web Store for Chrome, Brave, Arc, Vivaldi and Opera, on Edge Add-ons for Edge, and Firefox gets an add-on signed by Mozilla. The side panel runs on an agent CLI you are signed in to: Claude Code, Codex, or another supported one.

Then open the side panel and type or speak an instruction.

To update later:

npx browsentic@latest update

The extension updates itself from its store, and the two do not have to be the same version.

Requirements

  • Node.js 20 or newer
  • Chrome, Edge, Brave, Arc, Vivaldi, Opera or another Chromium browser, or Firefox 140 or newer
  • One agent CLI on your PATH, logged in: claude, codex, agy, vibe, grok, cursor-agent, qwen, opencode or dsh

Commands

browsentic setup start the Bridge, add the extension to a browser and pair it
browsentic update update the Bridge and restart it
browsentic browsers the browsers on this computer and where each gets the extension
browsentic pair issue a fresh single-use code
browsentic status the Bridge, each paired browser and the agent
browsentic sessions list paired browsers
browsentic revoke unpair one browser, or all of them
browsentic agent choose which agent runs the side panel
browsentic logs tail the Bridge's log
browsentic mcp serve MCP over stdio

browsentic help lists the rest. A browser that cannot reach a store can load the extension from a folder this package carries: browsentic setup --unpacked.

Using it from an MCP client

Optional, and the side panel needs none of it. Registering Browsentic with an MCP client lets that client drive the same browser from a terminal.

npm i -g browsentic
claude mcp add browsentic -- browsentic mcp

Any MCP client works: Claude Code, Codex, Cursor, Zed, Claude Desktop. One Bridge owns the browser link, so several can share the same paired browser at once.

Prefer a global install over npx here. An npx command re-resolves on every client start and can quietly start a different Bridge than the one you set up.

Documentation

Full documentation lives at browsentic.com/docs, including the security model, the tool reference and the architecture.

Source: github.com/imshaikot/browsentic · Apache 2.0