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.

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.md
index 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.md
index 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:
```sh
npx browsentic setup
diff --git a/docs/guide/mac-app.md b/docs/guide/mac-app.md
index 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:
```sh
xattr -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 card
at `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.md
index 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 univ
too. With none of them the build is ad hoc, which runs where it was built and is blocked by
Gatekeeper 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 the
GitHub release after the npm publish. Colours in
[Theme.swift](../../src/mac/Sources/Browsentic/Theme/Theme.swift) are Ember and Daylight from
diff --git a/scripts/release-notes.mjs b/scripts/release-notes.mjs
index 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.swift
index 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")
}
}
}