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
refactor: speak of the desktop app rather than the Mac app wherever a Windows one will answer too, and tell a Windows user to uninstall it from Settings
Shahriard9d93f3f52bd
diff --git a/src/daemon/cli.ts b/src/daemon/cli.tsindex b5cf9af..aeeaa2f 100644--- a/src/daemon/cli.ts+++ b/src/daemon/cli.ts@@ -61,7 +61,7 @@ const USAGE = `browsentic ${pkg.version} — hand your real browser to the agentbrowsentic restart stop the daemon and bring up a fresh onebrowsentic token print the control token (for MCP clients, not the browser)- agent, skills, approvals, tasks and downloads take --json, which is what the macOS app reads.+ agent, skills, approvals, tasks and downloads take --json, which is what the desktop app reads.browsentic --version print the versionGetting started: browsentic setup@@ -530,6 +530,11 @@ async function setupFirefox({ json, restart: fresh, pair }: { json: boolean; resconsole.log(` Then open the sidebar and say what you want.\n`);}+const APP_REMOVAL = {+ darwin: 'drag Browsentic.app from Applications to the Trash',+ win32: 'uninstall Browsentic in Settings › Apps › Installed apps',+} as const;+/*** Remove Browsentic in one command.*@@ -576,7 +581,7 @@ async function uninstall(argv: string[]): Promise<void> {console.log(' live in extension storage rather than on disk.');if (kind === 'global') console.log('\n the command itself: npm rm -g browsentic');if (kind === 'repo') console.log('\n the global link: yarn daemon:unlink');- if (kind === 'app') console.log('\n the app itself: drag Browsentic.app from Applications to the Trash');+ if (kind === 'app') console.log(`\n the app itself: ${APP_REMOVAL[process.platform === 'win32' ? 'win32' : 'darwin']}`);console.log('\n the entry in your MCP client, e.g. claude mcp remove browsentic');if (flag('dry-run')) {diff --git a/src/daemon/daemon.ts b/src/daemon/daemon.tsindex f72306f..7102ff2 100644--- a/src/daemon/daemon.ts+++ b/src/daemon/daemon.ts@@ -790,7 +790,7 @@ export async function startDaemon({ version, idleExit = true }: DaemonOptions):return send(ws, {id: request.id,op: 'preferences',- result: failure('BLOCKED', 'An agent run cannot change the settings it runs under. Change them from the settings page or the Mac app.'),+ result: failure('BLOCKED', 'An agent run cannot change the settings it runs under. Change them from the settings page or the desktop app.'),});}send(ws, { id: request.id, op: 'preferences', result: applyPreference(request.change) });diff --git a/src/daemon/npx.ts b/src/daemon/npx.tsindex a411594..d2c251e 100644--- a/src/daemon/npx.ts+++ b/src/daemon/npx.ts@@ -8,7 +8,7 @@ export const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..'export type InstallKind = 'npx' | 'global' | 'repo' | 'app';-/** Written beside the payload by Browsentic.app when it lays the CLI down in ~/.browsentic/cli. */+/** Written beside the payload by the desktop app when it lays the CLI down in ~/.browsentic/cli. */export const APP_MARKER = '.browsentic-app.json';const inNpxCache = (path: string) => path.split(sep).includes('_npx');diff --git a/src/daemon/preferences.ts b/src/daemon/preferences.tsindex c58a413..dbe1072 100644--- a/src/daemon/preferences.ts+++ b/src/daemon/preferences.ts@@ -1,5 +1,5 @@/**- * The settings two surfaces share: the extension's settings page and the Mac app both read+ * The settings two surfaces share: the extension's settings page and the desktop app both read* and write them here, and config.json is the only copy. A change from either side, from the* CLI, or from a hand edit of the file reaches every open surface through `watchConfig`.*/diff --git a/src/daemon/self-update.ts b/src/daemon/self-update.tsindex 3732103..071b802 100644--- a/src/daemon/self-update.ts+++ b/src/daemon/self-update.ts@@ -59,7 +59,7 @@ export async function upgradeCli(current: string, forward: string[]): Promise<nu}if (kind === 'app') {- console.error(`\n ! browsentic ${latest} is published; this is ${current}, installed by Browsentic.app.`);+ console.error(`\n ! browsentic ${latest} is published; this is ${current}, installed by the Browsentic app.`);console.error(` Update it from the app, which replaces the command and the extension together.\n`);return null;}diff --git a/src/extension/entrypoints/options/App.tsx b/src/extension/entrypoints/options/App.tsxindex df4e0fe..a04d39a 100644--- a/src/extension/entrypoints/options/App.tsx+++ b/src/extension/entrypoints/options/App.tsx@@ -19,19 +19,19 @@ const SECTIONS: { id: SectionId; label: string; icon: LucideIcon; blurb: stringid: 'appearance',label: 'Appearance',icon: Palette,- blurb: 'How the side panel, the popup and this page look. Every paired browser follows the same choice, and the Mac app can change it too.',+ blurb: 'How the side panel, the popup and this page look. Every paired browser follows the same choice, and the desktop app can change it too.',},{id: 'guardrails',label: 'Guardrails',icon: ShieldCheck,- blurb: 'What the agent may do without asking you first. A run takes its policy when it starts, so a change applies to the next one. The Mac app’s Settings tab edits the same rows.',+ blurb: 'What the agent may do without asking you first. A run takes its policy when it starts, so a change applies to the next one. The desktop app’s Settings tab edits the same rows.',},{id: 'agent',label: 'Agent',icon: Sparkles,- blurb: 'Which agent CLI the side panel drives, and on which model. A switch here or in the Mac app reaches every paired browser.',+ blurb: 'Which agent CLI the side panel drives, and on which model. A switch here or in the desktop app reaches every paired browser.',},{id: 'connection',@@ -140,7 +140,7 @@ function Appearance() {<ThemePicker theme={theme} onSelect={setTheme} /><p className="text-xs leading-relaxed text-ink-faint">{daemon?.connected- ? 'Kept in the daemon’s config, so every paired browser and the Mac app see the change at once.'+ ? 'Kept in the daemon’s config, so every paired browser and the desktop app see the change at once.': 'Kept in this browser for now, and handed to the daemon the next time it connects.'}</p></div>diff --git a/src/lib/settings/preferences.ts b/src/lib/settings/preferences.tsindex e8705ae..e9f5539 100644--- a/src/lib/settings/preferences.ts+++ b/src/lib/settings/preferences.ts@@ -1,5 +1,5 @@/**- * Everything a person can set from either the extension's settings page or the Mac app. The+ * Everything a person can set from either the extension's settings page or the desktop app. The* daemon keeps it in config.json and hands the same snapshot to both, after every change,* whichever side made it — or a hand edit of the file.*/diff --git a/src/lib/settings/theme.ts b/src/lib/settings/theme.tsindex 9a76f87..600ff75 100644--- a/src/lib/settings/theme.ts+++ b/src/lib/settings/theme.ts@@ -1,6 +1,6 @@/*** The extension's four looks, named once for every side that sets one: the extension's own- * settings page, the Mac app, and config.json, where the daemon keeps the choice so each+ * settings page, the desktop app, and config.json, where the daemon keeps the choice so each* paired browser opens in the same one.*/