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
docs(mac): install the app with the one-line script, and keep the disk image as the fallback
Shahriar5e7d4d628e44
diff --git a/README.md b/README.mdindex e3fa39e..eff2381 100644--- a/README.md+++ b/README.md@@ -12,7 +12,11 @@ Hand your real, logged-in browser to the AI agent you already run. Browsentic is## Quick Start-**macOS** — download the DMG from the [latest release](https://github.com/imshaikot/browsentic/releases/latest), drag [Browsentic.app](docs/guide/mac-app.md) to Applications and open it. It installs everything, Node included, and runs it from a window.+**macOS** — one line installs [Browsentic.app](docs/guide/mac-app.md), and the app installs everything else, Node included, and runs it from a window:++```sh+curl -fsSL https://browsentic.com/install.sh | sh+```**Any platform** — with [Node.js](https://nodejs.org) 20 or newer:diff --git a/docs/guide/install.md b/docs/guide/install.mdindex 759b206..b7e1243 100644--- a/docs/guide/install.md+++ b/docs/guide/install.md@@ -29,8 +29,13 @@ Two things worth knowing before you start:## Install-On macOS there is an app that does all of this from a window, Node included:-[Browsentic for macOS](mac-app.md). Everywhere else, and on a Mac if you prefer a terminal:+On macOS there is an [app](mac-app.md) that does all of this from a window, Node included:++```sh+curl -fsSL https://browsentic.com/install.sh | sh+```++Everywhere else, and on a Mac if you would rather not have the app:```shnpx browsentic setupdiff --git a/docs/guide/mac-app.md b/docs/guide/mac-app.mdindex 19a6fd0..207e7c8 100644--- a/docs/guide/mac-app.md+++ b/docs/guide/mac-app.md@@ -10,20 +10,30 @@ Requires macOS 14 or newer, on Apple silicon or Intel.## Install-1. Download `Browsentic-<version>.dmg` from the- [latest release](https://github.com/imshaikot/browsentic/releases/latest).-2. Open it and drag **Browsentic** onto **Applications**.-3. Open the app.+```sh+curl -fsSL https://browsentic.com/install.sh | sh+```++That downloads the latest release, checks the app’s signature is intact, copies `Browsentic.app` into+Applications and opens it. It asks for no password. `BROWSENTIC_VERSION=0.6.0` pins a release, and+`BROWSENTIC_NO_OPEN=1` installs without opening. [Read the script](https://browsentic.com/install.sh)+first if you like — it is sixty lines.++### From the disk image instead-Until the release is notarized, macOS blocks the downloaded app with “Apple could not verify-Browsentic is free of malware”. Press **Done**, then either open **System Settings → Privacy &-Security**, scroll to the Browsentic line and press **Open Anyway**, or run:+Download `Browsentic-<version>.dmg` from the+[latest release](https://github.com/imshaikot/browsentic/releases/latest) and drag **Browsentic** onto+**Applications**. The build is not notarized yet, and macOS quarantines anything a browser+downloads, so the first open is blocked with “Apple could not verify Browsentic is free of+malware”. Press **Done**, then either open **System Settings → Privacy & Security**, scroll to the+Browsentic line and press **Open Anyway**, or run:```shxattr -dr com.apple.quarantine /Applications/Browsentic.app```-Right-click ▸ Open no longer gets past this on macOS 15 and newer.+Right-click ▸ Open no longer gets past this on macOS 15 and newer. The one-line install never meets+it, because `curl` does not quarantine what it downloads.## The first screen: what your Mac already has@@ -78,8 +88,8 @@ not two that can drift apart.## Updating-Settings shows a banner when a newer release is out. Download the new DMG, replace the app, open-it: the first screen notices the command and the extension are older than the ones it carries,+Settings shows a banner when a newer release is out. Run the install line again — it replaces the+app and opens it: the first screen notices the command and the extension are older than the ones it carries,and **Set up everything** replaces both and restarts the daemon. Then press ↻ on the Browsentic cardat `chrome://extensions`, which is the one step no installer can do for you.diff --git a/docs/internals/mac-app.md b/docs/internals/mac-app.mdindex 9cb4ec2..96c04a9 100644--- a/docs/internals/mac-app.md+++ b/docs/internals/mac-app.md@@ -64,6 +64,12 @@ ARCHS=arm64 Scripts/build-app.sh # quick local bundle; the default is a univtoo. With none of them the build is ad hoc, which runs where it was built and is blocked byGatekeeper anywhere it was downloaded to.+That is why the install path people are pointed at is `curl -fsSL https://browsentic.com/install.sh | sh`:+`curl` sets no quarantine flag, so Gatekeeper never assesses the app. The script lives on the+`website` branch as `public/install.sh`, resolves the newest release from the `releases/latest`+redirect, verifies the signature, and copies the app into Applications. It depends on the release+asset being named `Browsentic-<version>.dmg`.+CI builds and tests it on `macos-15`; the release workflow’s `mac` job attaches the DMG to theGitHub release after the npm publish. Colours in[Theme.swift](../../src/mac/Sources/Browsentic/Theme/Theme.swift) are Ember and Daylight fromdiff --git a/scripts/release-notes.mjs b/scripts/release-notes.mjsindex 4eab926..97e9aef 100644--- a/scripts/release-notes.mjs+++ b/scripts/release-notes.mjs@@ -91,9 +91,14 @@ function renderNotes(version, commits, prevTag) {lines.push('### Install','',- `**macOS** — download \`Browsentic-${version}.dmg\` below, drag the app to Applications and open it. It installs`,- 'everything, Node included. If macOS says it could not verify the app, press **Done**, then **System Settings →',- 'Privacy & Security → Open Anyway**, or run `xattr -dr com.apple.quarantine /Applications/Browsentic.app`.',+ '**macOS** — installs the app, and the app installs everything else, Node included:',+ '',+ '```sh',+ 'curl -fsSL https://browsentic.com/install.sh | sh',+ '```',+ '',+ `The \`Browsentic-${version}.dmg\` below is the same app. It is not notarized yet, so a downloaded copy is blocked`,+ 'on first open: **System Settings → Privacy & Security → Open Anyway**. The line above avoids that.','','**Any platform**','',diff --git a/src/mac/Sources/Browsentic/Views/SettingsView.swift b/src/mac/Sources/Browsentic/Views/SettingsView.swiftindex 1785436..18e2374 100644--- a/src/mac/Sources/Browsentic/Views/SettingsView.swift+++ b/src/mac/Sources/Browsentic/Views/SettingsView.swift@@ -7,6 +7,8 @@ struct SettingsView: View {@State private var confirmingUninstall = false@State private var keepSkills = true+ private static let installLine = "curl -fsSL https://browsentic.com/install.sh | sh"+private var mcpCommand: String { "claude mcp add browsentic -- \(Paths.mcpShim.path)" }var body: some View {@@ -15,10 +17,9 @@ struct SettingsView: View {Card {HStack(spacing: 14) {Image(systemName: "arrow.down.circle.fill").font(.system(size: 22)).foregroundStyle(Palette.brand)- SectionTitle(title: "Browsentic \(latest) is out", subtitle: "You have \(model.appVersion). The new app replaces the command and the extension together.")+ SectionTitle(title: "Browsentic \(latest) is out", subtitle: "You have \(model.appVersion). Paste this into a terminal and it replaces the app, which then replaces the command and the extension: \(Self.installLine)")Spacer()- Button("Download") { NSWorkspace.shared.open(URL(string: "https://github.com/imshaikot/browsentic/releases/latest")!) }- .buttonStyle(PrimaryButtonStyle())+ CopyButton(value: Self.installLine, label: "Copy the line")}}}