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
feat(setup): Edge gets the extension from the Chrome Web Store again, which approves updates far sooner than Edge Add-ons: setup, browsentic browsers and the apps open it in Edge and say to allow extensions from other stores first; the Edge Add-ons listing stays advertised, and copies installed from it still pair and update
Shahriar623ccfbd1586
diff --git a/README.md b/README.mdindex 9bb2e7c..60b1a5b 100644--- a/README.md+++ b/README.md@@ -68,7 +68,7 @@ irm https://browsentic.com/install.ps1 | iexnpx browsentic@latest setup```-Setup asks which browser you use and opens Browsentic's store page in it (the apps do the same from their Overview tab). Press **Add to Chrome** (**Get** in Edge, **Add** in Firefox), then click Browsentic in the toolbar and enter the code setup shows. From then on the extension updates itself from its store.+Setup asks which browser you use and opens Browsentic's store page in it (the apps do the same from their Overview tab). Press **Add to Chrome** (**Add** in Firefox; Edge first asks you to allow extensions from other stores), then click Browsentic in the toolbar and enter the code setup shows. From then on the extension updates itself from its store.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:diff --git a/docs/guide/install.md b/docs/guide/install.mdindex 2f67609..c256501 100644--- a/docs/guide/install.md+++ b/docs/guide/install.md@@ -14,7 +14,7 @@ The extension is on thefor Chrome, Brave, Arc, Vivaldi and Opera, on[Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browsentic/cbkjhkgjcpihokphhdkbahilpcjojpdc)for Edge, and Firefox gets an [add-on signed by Mozilla](https://browsentic.com/download/firefox).-Setup opens the right one for you.+Setup opens the Chrome Web Store in every Chromium browser, Edge included, and the add-on in Firefox.---@@ -74,7 +74,7 @@ extension:Which browser should get the extension?1 Chrome Chrome Web Store- 2 Edge Edge Add-ons+ 2 Edge Chrome Web Store3 Firefox signed add-on4 Another browser: load it unpacked@@ -99,7 +99,7 @@ Setup, or the app's button for that browser, opens Browsentic's store page in it| Browser | The page it opens | What to press || --- | --- | --- || Chrome, Brave, Arc, Vivaldi | [Chrome Web Store](https://chromewebstore.google.com/detail/browsentic/npmocgldfflonjjmdadmdefpnfagnjmp) | **Add to Chrome** (in Brave, **Add to Brave**) |-| Edge | [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browsentic/cbkjhkgjcpihokphhdkbahilpcjojpdc) | **Get** |+| Edge | [Chrome Web Store](https://chromewebstore.google.com/detail/browsentic/npmocgldfflonjjmdadmdefpnfagnjmp) | **Allow extensions from other stores** in the bar at the top, if Edge shows it, and confirm; then **Add to Chrome**. The [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browsentic/cbkjhkgjcpihokphhdkbahilpcjojpdc) copy works the same || Opera | [Chrome Web Store](https://chromewebstore.google.com/detail/browsentic/npmocgldfflonjjmdadmdefpnfagnjmp) | Opera first offers its **Install Chrome Extensions** helper: add it, then **Add to Opera** || Firefox 140 or newer | [The signed add-on](https://browsentic.com/download/firefox) | Accept both prompts: one lets github.com install software, one adds Browsentic. See [Firefox](#firefox) || Ungoogled Chromium, a profile that blocks stores, an unreleased build | None: `setup --unpacked` writes a folder | See [Load unpacked](#load-unpacked-advanced) |diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.mdindex 0572db6..5da0db3 100644--- a/docs/guide/troubleshooting.md+++ b/docs/guide/troubleshooting.md@@ -26,7 +26,7 @@ Those three answer most questions. The Bridge's log is at `~/.browsentic/daemon.| The popup says `protocol version mismatch: Browsentic Bridge speaks v22 and takes extensions from v22 on` | The extension is older than 0.7.14, usually an unpacked copy that was never updated | Remove it and install the extension from its store, or run `browsentic update` and press ↻ on its card || The store copy is a version behind the Bridge | The store has not published that version yet, or the browser checked before it did. A browser allows the extension one early check every few hours | Nothing breaks meanwhile, because the two work across versions. Once the browser has the update, the side panel says so above the prompt: press **Update**. To check now, turn on Developer mode at `chrome://extensions` and press **Update** there || `browsentic status` says two copies of Browsentic answer in one browser | An unpacked copy and a store copy are both installed, and both inject into every page | Remove the unpacked copy on the browser's extensions page |-| Edge will not install from the Chrome Web Store | Edge blocks other stores until you allow them | Install from [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browsentic/cbkjhkgjcpihokphhdkbahilpcjojpdc) instead. Or press **Allow extensions from other stores** in the bar at the top of the store page, confirm, then press **Add to Chrome** |+| Edge will not install from the Chrome Web Store | Edge blocks other stores until you allow them | Press **Allow extensions from other stores** in the bar at the top of the store page, confirm, then press **Add to Chrome**. Or install from [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browsentic/cbkjhkgjcpihokphhdkbahilpcjojpdc) instead || `browsentic setup` keeps waiting for the browser | The extension is installed but not paired yet | Click Browsentic in the toolbar and enter the code `setup` printed. Ctrl-C stops the wait without undoing anything || Popup shows `Expected {op:…}` | Stale service worker after a rebuild | At `chrome://extensions`, press ↻ on Browsentic || "That pairing code is wrong or expired" | Codes are single-use and last 10 minutes | Run `browsentic pair` for a new code. A failed attempt does not use up the outstanding code |diff --git a/docs/internals/stores.md b/docs/internals/stores.mdindex 9ec44ad..b1b19f0 100644--- a/docs/internals/stores.md+++ b/docs/internals/stores.md@@ -18,7 +18,9 @@ for them. Firefox has no store listing; every GitHub release carries a signed `.The IDs are fixed for good, and three places depend on them:- [`src/lib/stores.ts`](../../src/lib/stores.ts) names them, and says where each browser gets the- extension: Edge from Edge Add-ons, every other Chromium browser from the Chrome Web Store.+ extension: every Chromium browser from the Chrome Web Store, Edge included, because Edge+ installs from it and Edge Add-ons approves an update far more slowly. The Edge Add-ons listing+ stays up for anyone who finds it there, and its copies pair and update the same way.- The native messaging host lets both store IDs start Browsentic Bridge whether or not they havepaired yet ([native-host.ts](../../src/daemon/native-host.ts)).- The Bridge names each session's source from its origin: a store ID, a `moz-extension://` origin,diff --git a/docs/reference/cli.md b/docs/reference/cli.mdindex f4ac7ae..4fdd01e 100644--- a/docs/reference/cli.md+++ b/docs/reference/cli.md@@ -23,8 +23,8 @@ With no command it prints usage. Most commands start the Bridge if it is not alr| `browsentic uninstall` | Stop the Bridge and remove everything Browsentic wrote |On a terminal, `setup` checks your agent and asks which browser should get the extension. It opens-that browser's store page in it (the Chrome Web Store for Chrome, Brave, Arc, Vivaldi, Opera and-Chromium; Edge Add-ons for Edge; the signed add-on for Firefox), prints a pairing code, and waits+that browser's store page in it (the Chrome Web Store for Chrome, Edge, Brave, Arc, Vivaldi, Opera+and Chromium; the signed add-on for Firefox), prints a pairing code, and waitsup to five minutes for the browser to connect. Ctrl-C stops the wait and undoes nothing. With noterminal and no `--browser`, it asks nothing: it prints where each browser gets the extension and acode, so a script or an app never hangs on it.diff --git a/scripts/release-notes.mjs b/scripts/release-notes.mjsindex 4ac9ebe..7323f33 100644--- a/scripts/release-notes.mjs+++ b/scripts/release-notes.mjs@@ -119,7 +119,7 @@ function renderNotes(version, commits, prevTag) {`npx browsentic@${version} setup`,'```','',- 'Press **Add to Chrome** (**Get** in Edge, **Add** in Firefox) on the page it opens, then click Browsentic in the toolbar',+ 'Press **Add to Chrome** (**Add** in Firefox; Edge first asks you to allow extensions from other stores) on the page it opens, then click Browsentic in the toolbar','and enter the pairing code. The apps do the same from their Overview tab. The side panel runs on an agent CLI you are','signed in to: Claude Code, Codex, or another supported one.','',diff --git a/src/daemon/README.md b/src/daemon/README.mdindex 3e8db9c..e61513f 100644--- a/src/daemon/README.md+++ b/src/daemon/README.md@@ -17,8 +17,8 @@ npx browsentic@latest setup```It starts Browsentic Bridge, asks which browser you use, opens the extension's store page there,-prints a pairing code and waits for the browser to connect. Press **Add to Chrome** (**Get** in-Edge, **Add** in Firefox), click Browsentic in the toolbar and enter the code, once. On macOS and Windows an app does+prints a pairing code and waits for the browser to connect. Press **Add to Chrome** (**Add** in+Firefox; Edge first asks you to allow extensions from other stores), click Browsentic in the toolbar and enter the code, once. On macOS and Windows an app doesthe same from a window: see [browsentic.com/install](https://browsentic.com/install/).The extension is on thediff --git a/src/daemon/browsers.test.ts b/src/daemon/browsers.test.tsindex b51a4cb..8c88a13 100644--- a/src/daemon/browsers.test.ts+++ b/src/daemon/browsers.test.ts@@ -2,23 +2,23 @@ import { describe, expect, test } from 'vitest';import { browserOf, launch, locateBrowsers, sourceFor, storeSteps, storeUrl } from './browsers';describe('where each browser gets the extension', () => {- test('every Chromium browser from the Chrome Web Store, Edge from Edge Add-ons, Firefox the signed add-on', () => {+ test('every Chromium browser from the Chrome Web Store, Edge included, Firefox the signed add-on', () => {expect([sourceFor('chrome'), sourceFor('brave'), sourceFor('edge'), sourceFor('firefox')]).toEqual(['chrome-web-store','chrome-web-store',- 'edge-add-ons',+ 'chrome-web-store','firefox',]);- expect(storeUrl('edge', '0.8.0')).toBe('https://microsoftedge.microsoft.com/addons/detail/browsentic/cbkjhkgjcpihokphhdkbahilpcjojpdc');+ expect(storeUrl('edge', '0.8.0')).toBe('https://chromewebstore.google.com/detail/browsentic/npmocgldfflonjjmdadmdefpnfagnjmp');expect(storeUrl('firefox', '0.8.0')).toBe('https://github.com/imshaikot/browsentic/releases/download/v0.8.0/browsentic-0.8.0-firefox.xpi',);});- test('Opera is told to add its helper first, and the rest the button they show', () => {+ test('Opera is told to add its helper first, Edge to allow other stores, and the rest the button they show', () => {expect([storeSteps('opera')[0], storeSteps('edge')[0], storeSteps('brave')[0]]).toEqual([expect.stringContaining('Install Chrome Extensions'),- 'Press “Get”.',+ expect.stringMatching(/^Press “Allow extensions from other stores”.*“Add to Chrome”\.$/),'Press “Add to Brave”.',]);});diff --git a/src/daemon/browsers.ts b/src/daemon/browsers.tsindex 8cdaf81..a92b7fb 100644--- a/src/daemon/browsers.ts+++ b/src/daemon/browsers.ts@@ -8,7 +8,7 @@ import { execFileSync, spawn } from 'node:child_process';import { existsSync } from 'node:fs';import { homedir } from 'node:os';import { posix } from 'node:path';-import { CHROME_WEB_STORE, EDGE_ADD_ONS, SOURCE_LABEL, type Source } from '@/lib/stores';+import { CHROME_WEB_STORE, SOURCE_LABEL, type Source } from '@/lib/stores';import type { SessionSummary } from './control';import { signedAddonUrl } from './firefox-addon';@@ -44,7 +44,7 @@ export const BROWSERS: Record<BrowserId, BrowserEntry> = {label: 'Edge',brand: /Edge/i,extensionsPage: 'edge://extensions',- button: 'Get',+ button: 'Add to Chrome',mac: 'Microsoft Edge.app',linux: ['microsoft-edge', 'microsoft-edge-stable'],windows: ['msedge.exe', 'Microsoft\\Edge\\Application\\msedge.exe'],@@ -103,15 +103,13 @@ export const BROWSERS: Record<BrowserId, BrowserEntry> = {},};+/** Edge included: it installs from the Chrome Web Store, which approves updates far sooner than Edge Add-ons. */export function sourceFor(id: BrowserId): Source {- if (id === 'firefox') return 'firefox';- return id === 'edge' ? 'edge-add-ons' : 'chrome-web-store';+ return id === 'firefox' ? 'firefox' : 'chrome-web-store';}export function storeUrl(id: BrowserId, version: string): string {- const source = sourceFor(id);- if (source === 'firefox') return signedAddonUrl(version);- return source === 'edge-add-ons' ? EDGE_ADD_ONS.url : CHROME_WEB_STORE.url;+ return sourceFor(id) === 'firefox' ? signedAddonUrl(version) : CHROME_WEB_STORE.url;}/** What to press once the page is open, in that browser's own words. */@@ -119,6 +117,9 @@ export function storeSteps(id: BrowserId): string[] {if (id === 'firefox') {return ['Firefox asks whether to let github.com install software, then whether to add Browsentic. Say yes to both.'];}+ if (id === 'edge') {+ return ['Press “Allow extensions from other stores” if Edge shows it at the top of the page, confirm, and press “Add to Chrome”.'];+ }if (id === 'opera') {return ['Opera first offers its “Install Chrome Extensions” helper: add it, then press “Add to Opera”.'];}diff --git a/src/daemon/cli.ts b/src/daemon/cli.tsindex ee1acc1..f656fc7 100644--- a/src/daemon/cli.ts+++ b/src/daemon/cli.ts@@ -686,8 +686,6 @@ function printPlan(rows: BrowserRow[], sessions: SessionSummary[], folderVersionconst store = (id: BrowserId) => rows.find((row) => row.id === id)!;console.log(` ${chromeWebStore.join(', ')}`);console.log(` ${store('chrome').storeUrl}`);- console.log(` Edge`);- console.log(` ${store('edge').storeUrl}`);console.log(` Firefox`);console.log(` ${store('firefox').storeUrl}\n`);const [enter, ...rest] = codeLines(code);diff --git a/src/mac/Packaging/dmg-readme.txt b/src/mac/Packaging/dmg-readme.txtindex 50cd2cc..12d7298 100644--- a/src/mac/Packaging/dmg-readme.txt+++ b/src/mac/Packaging/dmg-readme.txt@@ -8,8 +8,8 @@ what your Mac already has, installs what is missing with one click, and keeps it~/.browsentic the command, pairing keys, config and logsThe other half is the extension in your browser. The app's Overview tab opens its store-page in the browser you pick: the Chrome Web Store for Chrome, Brave, Arc, Vivaldi-and Opera, Edge Add-ons for Edge, or the signed add-on for Firefox. Click Browsentic+page in the browser you pick: the Chrome Web Store for Chrome, Edge, Brave, Arc,+Vivaldi and Opera, or the signed add-on for Firefox. Click Browsenticin the toolbar and enter the pairing code the app shows, once.If macOS says it "could not verify Browsentic is free of malware", this build wasdiff --git a/src/windows/ui/mock-backend.ts b/src/windows/ui/mock-backend.tsindex fcb73ad..e07e861 100644--- a/src/windows/ui/mock-backend.ts+++ b/src/windows/ui/mock-backend.ts@@ -166,7 +166,6 @@ const SESSIONS = [const STORES = {'chrome-web-store': { store: 'Chrome Web Store', storeUrl: 'https://chromewebstore.google.com/detail/browsentic/npmocgldfflonjjmdadmdefpnfagnjmp' },- 'edge-add-ons': { store: 'Edge Add-ons', storeUrl: 'https://microsoftedge.microsoft.com/addons/detail/browsentic/cbkjhkgjcpihokphhdkbahilpcjojpdc' },firefox: { store: 'Firefox add-on', storeUrl: 'https://github.com/imshaikot/browsentic/releases/download/v0.8.0/browsentic-0.8.0-firefox.xpi' },};@@ -174,7 +173,7 @@ function rows(): BrowserRow[] {const row = (id: BrowserRow['id'], label: string, brand: string, installed: boolean): BrowserRow => {const sessions = SESSIONS.filter((session) => session.browser === brand).map(({ id, source, extensionVersion, connected }) => ({ id, source, extensionVersion, connected }));const firefox = id === 'firefox';- const source = firefox ? 'firefox' : id === 'edge' ? 'edge-add-ons' : 'chrome-web-store';+ const source = firefox ? 'firefox' : 'chrome-web-store';return {id,label,@@ -184,7 +183,9 @@ function rows(): BrowserRow[] {steps: [firefox? 'Firefox asks whether to let github.com install software, then whether to add Browsentic. Say yes to both.'- : `Press “${id === 'edge' ? 'Get' : label === 'Brave' ? 'Add to Brave' : 'Add to Chrome'}”.`,+ : id === 'edge'+ ? 'Press “Allow extensions from other stores” if Edge shows it at the top of the page, confirm, and press “Add to Chrome”.'+ : `Press “${label === 'Brave' ? 'Add to Brave' : 'Add to Chrome'}”.`,],extensionsPage: firefox ? 'about:addons' : `${id === 'edge' ? 'edge' : id === 'brave' ? 'brave' : 'chrome'}://extensions`,connected: sessions.some((session) => session.connected),diff --git a/src/windows/ui/model.test.ts b/src/windows/ui/model.test.tsindex e52682e..e146ba3 100644--- a/src/windows/ui/model.test.ts+++ b/src/windows/ui/model.test.ts@@ -128,7 +128,7 @@ describe('the running app', () => {await until(model, (state) => state.browserRows.length > 0);expect(model.offeredBrowsers.map((row) => [row.id, row.store, row.connected])).toEqual([['chrome', 'Chrome Web Store', true],- ['edge', 'Edge Add-ons', false],+ ['edge', 'Chrome Web Store', false],['brave', 'Chrome Web Store', true],['firefox', 'Firefox add-on', false],]);@@ -140,7 +140,7 @@ describe('the running app', () => {await model.addExtension(model.offeredBrowsers.find((row) => row.id === 'edge')!);expect([model.snapshot().pairing?.code, model.snapshot().notice?.text]).toEqual(['R4TW7KXE',- 'Press “Get”. Then click Browsentic in Edge’s toolbar and enter the code below.',+ 'Press “Allow extensions from other stores” if Edge shows it at the top of the page, confirm, and press “Add to Chrome”. Then click Browsentic in Edge’s toolbar and enter the code below.',]);});