Skip to content

Install

Install Browsentic on macOS, Windows or Linux

About two minutes. One line installs Browsentic Bridge on your computer, opens the extension’s store page in your browser, and shows a one-time code to pair the two.

On macOS

curl -fsSL https://browsentic.com/install.sh | sh

On Windows, in PowerShell (experimental)

irm https://browsentic.com/install.ps1 | iex

Anywhere, with Node.js 20 or newer

npx browsentic@latest setup

Setup asks which browser you use and opens the extension’s store page there. Press Add, click Browsentic in the toolbar and enter the code setup shows, once.

Requirements

  • A browser

    Chrome, Edge, Brave, Arc, Vivaldi or Opera, or Firefox 140 or newer.

  • Node.js 20 or newer

    For the command line only. The apps bring their own.

  • One agent CLI, signed in

    Claude Code, Codex, Antigravity, Mistral Vibe, Grok Build, Cursor CLI, Qwen Code or OpenCode. Nothing to paste into Browsentic.

Command line

Install with npx on any platform

Four steps, the last one optional. Press a step to watch it again.

  1. 01

    Run setup

    It starts Browsentic Bridge, checks your agent CLI, asks which browser to set up and opens the extension’s store page there. Nothing to clone or build.

    npx browsentic@latest setup
  2. 02

    Add the extension

    Press Add to Chrome on the page setup opened. Brave, Arc, Vivaldi and Opera use the same page; Edge opens its own Edge Add-ons listing, where you press Get. It updates itself from then on.

    On Firefox, run npx browsentic@latest setup --browser firefox and accept both prompts for the signed add-on it opens. It updates itself.

  3. 03

    Pair the browser

    Click Browsentic in the toolbar, enter the code setup printed and press Connect. A code works once, for ten minutes; this command prints a new one.

    npx browsentic pair
  4. 04

    Optional: add it to an MCP client

    The side panel works without this. It gives Claude Code the same browser; Codex, Cursor and Zed work too.

    claude mcp add browsentic -- browsentic mcp

Desktop apps

Install with the macOS or Windows app

One line installs the app. One button in it installs Browsentic Bridge, and one per browser adds the extension.

macOS app

macOS 14 or newer. No password, nothing to drag.

curl -fsSL https://browsentic.com/install.sh | sh

The disk image is not notarized yet: on first open press Done, then Open Anyway under System Settings, Privacy and Security. Download the disk image · macOS app guide

Windows app

Experimental

Windows 10 or 11, x64 or ARM64. Installs for you alone, no administrator.

irm https://browsentic.com/install.ps1 | iex

The installer is not code-signed yet: when SmartScreen warns, press More info, then Run anyway. Download the installer · Windows app guide

  1. 01

    Run the line

    It downloads the latest release for your computer, installs the app and opens it.

  2. 02

    Press Set up everything

    It installs whatever is missing, Node.js and Browsentic Bridge, and offers Claude Code if no agent is ready.

  3. 03

    Add it to your browser

    Every browser gets a row. Its button opens the store page in that browser and shows the pairing code to enter, once.

Check

Check that it is connected

browsentic status reports every part. A working install looks like this.

EXTENSION_OFFLINE

No browser is paired or open. Click Browsentic in the toolbar and enter a new pairing code.

AGENT_MISSING

The agent CLI is not on the Bridge’s PATH. Set agents.<name>.bin to its full path.

TAB_UNREACHABLE

The extension has not reached that tab yet. Reload the page.

Later

Update or uninstall

npx browsentic@latest update

Updates Browsentic Bridge and restarts it; the browser stays paired. The extension updates itself from its store, and the two do not have to be the same version. The apps offer each update on their Overview tab.

npx browsentic uninstall

Stops the Bridge and removes its folders, after showing you the plan. Remove the extension from your browser yourself: right-click its icon, then Remove.

Questions

Install questions people ask

Do I need an API key to install Browsentic?

No. Browsentic starts the agent CLI you already signed in to, such as Claude Code or Codex, as you. There is nothing to paste into Browsentic.

Where does the extension come from?

The Chrome Web Store for Chrome, Brave, Arc, Vivaldi and Opera, and Edge Add-ons for Edge. Setup opens the right one for you: press Add to Chrome, or Get in Edge, and it updates itself from then on. Firefox gets a Mozilla-signed add-on from each release, which updates itself too. A browser that cannot reach a store can load it from a folder: npx browsentic@latest setup --unpacked.

What is Browsentic Bridge?

The half of Browsentic that runs on your computer. An extension cannot start a program on its own, so the Bridge does: it listens on your own machine only, runs the agent CLI you chose, and keeps everything local. The Mac and Windows apps are the Bridge in a window; npx browsentic@latest setup is the same thing from a terminal.

The pairing code expired. What now?

Run npx browsentic pair for a new one, or press Get a pairing code in the app. Each code works once and lasts ten minutes. Once paired, the browser keeps a session key and never needs a code again, even after an update.

Does Browsentic work on Linux?

Yes. Run npx browsentic@latest setup with Node.js 20 or newer: it opens the extension on the Chrome Web Store, or the Firefox add-on, in the browser you pick. The macOS and Windows apps are optional: everything they do, the command does too.

Give your browser a superpower.

Free and open source under Apache 2.0, with no API key, subscription or account. One line installs Browsentic Bridge and opens the extension’s store page. Nothing connects until you pair the two.