The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu
Go agent-ai-cliagent-harnessesagent-securitybrowser-extensionciclaude-codecloudcodexcursordetection-engineeringjevknowledge-basememorymobile-device-managementobservabilitysecuritysecurity-information-and-event-managementsecurity-toolstelemetrytraces
docs, cli: run brew update before every Homebrew install and upgrade
shukieshah63b1c76e8ca0
diff --git a/README.md b/README.mdindex f73b46d7..547a3778 100644--- a/README.md+++ b/README.md@@ -84,6 +84,7 @@ Read https://beacon.sh/start.md then set me up on Beacon<summary><strong>macOS</strong></summary>```bash+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/cli/beacon/.goreleaser.yaml b/cli/beacon/.goreleaser.yamlindex 27454e6c..6e6336fa 100644--- a/cli/beacon/.goreleaser.yaml+++ b/cli/beacon/.goreleaser.yaml@@ -302,6 +302,8 @@ release:### Homebrew (macOS/Linux)```bash+ brew update+ brew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacon```diff --git a/cli/beacon/cmd/endpoint_update.go b/cli/beacon/cmd/endpoint_update.goindex 51d10d50..4acb8a61 100644--- a/cli/beacon/cmd/endpoint_update.go+++ b/cli/beacon/cmd/endpoint_update.go@@ -164,7 +164,7 @@ func maybeReturnAfterUpdateReport(res selfupdate.CheckResult) error {switch res.Install.Kind {case selfupdate.InstallHomebrew:fmt.Println("Installed via Homebrew. Update with:")- fmt.Println(" brew upgrade beacon")+ fmt.Println(" brew update && brew upgrade beacon")return nilcase selfupdate.InstallOther:fmt.Printf("Endpoint package checks apply only to the system package install.\n")@@ -182,7 +182,7 @@ func maybeReturnAfterUpdateReport(res selfupdate.CheckResult) error {switch res.Install.Kind {case selfupdate.InstallHomebrew:fmt.Println("Installed via Homebrew. Update with:")- fmt.Println(" brew upgrade beacon")+ fmt.Println(" brew update && brew upgrade beacon")return fmt.Errorf("manual apply is not supported for Homebrew installs")case selfupdate.InstallOther:return fmt.Errorf("manual apply is supported only for the system package install (detected: %s)", res.Install.Kind)diff --git a/cli/beacon/cmd/root.go b/cli/beacon/cmd/root.goindex 2ddd4d87..c41be55b 100644--- a/cli/beacon/cmd/root.go+++ b/cli/beacon/cmd/root.go@@ -119,7 +119,7 @@ func printRootUpdateNotice(out io.Writer, result updatecheck.Result, color bool,fmt.Fprintf(out, "Release notes: %s\n", beaconCLIChangelogURL)switch install.Kind {case selfupdate.InstallHomebrew:- fmt.Fprintln(out, "Update with: brew upgrade beacon")+ fmt.Fprintln(out, "Update with: brew update && brew upgrade beacon")case selfupdate.InstallSystemPkg:fmt.Fprintln(out, "Update with: sudo beacon endpoint update --apply")default:diff --git a/cli/beacon/cmd/root_test.go b/cli/beacon/cmd/root_test.goindex 3dc59ecc..f4813363 100644--- a/cli/beacon/cmd/root_test.go+++ b/cli/beacon/cmd/root_test.go@@ -58,7 +58,7 @@ func TestPrintRootUpdateNotice(t *testing.T) {install selfupdate.Installcommand string}{- {name: "homebrew", install: selfupdate.Install{Kind: selfupdate.InstallHomebrew}, command: "brew upgrade beacon"},+ {name: "homebrew", install: selfupdate.Install{Kind: selfupdate.InstallHomebrew}, command: "brew update && brew upgrade beacon"},{name: "system package", install: selfupdate.Install{Kind: selfupdate.InstallSystemPkg}, command: "sudo beacon endpoint update --apply"},}for _, tt := range tests {diff --git a/cli/beacon/cmd/version_check.go b/cli/beacon/cmd/version_check.goindex 276f6abd..d03559e2 100644--- a/cli/beacon/cmd/version_check.go+++ b/cli/beacon/cmd/version_check.go@@ -103,7 +103,7 @@ func runVersionCheck(cmd *cobra.Command, args []string) error {}if result.UpdateAvailable {fmt.Fprintf(out, "Beacon %s is available. Current version: %s\n", result.LatestVersion, result.CurrentVersion)- fmt.Fprintln(out, "If installed with Homebrew: brew upgrade beacon")+ fmt.Fprintln(out, "If installed with Homebrew: brew update && brew upgrade beacon")fmt.Fprintf(out, "Download: %s\n", releaseDownloadURL(result))return nil}diff --git a/cli/beacon/cmd/version_check_test.go b/cli/beacon/cmd/version_check_test.goindex 4d82ef1f..cfc86f9e 100644--- a/cli/beacon/cmd/version_check_test.go+++ b/cli/beacon/cmd/version_check_test.go@@ -123,7 +123,7 @@ func TestRunVersionCheckReportsAvailableUpdate(t *testing.T) {})for _, want := range []string{"Beacon v0.0.12 is available. Current version: v0.0.10",- "If installed with Homebrew: brew upgrade beacon",+ "If installed with Homebrew: brew update && brew upgrade beacon","Download: https://example.test/releases/v0.0.12",} {if !strings.Contains(got, want) {diff --git a/docs/changelog/cli.mdx b/docs/changelog/cli.mdxindex 4cbb253d..d0a91379 100644--- a/docs/changelog/cli.mdx+++ b/docs/changelog/cli.mdx@@ -17,6 +17,7 @@ Stay up to date with the latest changes to the Agent Beacon CLI.## October 2026+- **Homebrew instructions refresh Homebrew first** · Every install and upgrade command in the docs, the release notes, and the update notice that `beacon`, `beacon version check` and `beacon endpoint update` print now starts with `brew update`. Without it, `brew tap` keeps whatever copy of `asymptote-labs/tap` the machine already has, so a Mac that had installed Beacon before got that older release again, and `brew upgrade beacon` reported no update for up to a day after a release. On an older Homebrew, `brew trust` also failed before anything could update Homebrew itself.- **Status and doctor recognize the hooks install writes** · Since v1.2.0, install writes hook commands with `--log` and `--config` flags in place of the `BEACON_ENDPOINT_MODE=1` prefix, but `beacon endpoint status`, `beacon endpoint doctor` and discovery still looked for the prefix. Every fresh install therefore reported Cursor, Antigravity CLI, Devin CLI, Devin Desktop and Hermes Agent as "hooks exist but endpoint hooks were not found", with telemetry disabled, though the hooks were correct and running, and inventory marked their hooks files as not Beacon-managed. They now use the same check install, repair and uninstall use, which accepts both spellings.### v1.3.44 · October 19, 2026diff --git a/docs/cli/install.mdx b/docs/cli/install.mdxindex 528d4a57..62dfc00b 100644--- a/docs/cli/install.mdx+++ b/docs/cli/install.mdx@@ -21,14 +21,17 @@ This page installs the **CLI**. Setting up the endpoint agent, the local collectInstall the Beacon CLI with Homebrew:```bash title="Install Beacon"+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beaconbeacon version```-`brew trust` is a one-time step for newer Homebrew releases before loading-third-party formulae from the tap.+`brew update` comes first: it brings Homebrew up to a release that has `brew trust`, and it refreshes a+copy of `asymptote-labs/tap` the machine already has, which `brew tap` leaves as it is, so the install+gets the latest Beacon rather than whatever release that copy last saw. `brew trust` is a one-time step+for newer Homebrew releases before loading third-party formulae from the tap.On macOS the formula also depends on `asymptote-labs/tap/beacon-vector`, the tap's mirror of Vector's releases (Vector is not in homebrew-core), which runs the optional [Beacon Cloud forwarder](/cli/endpoint-connect); Homebrew installs it alongside Beacon so no second step is needed.diff --git a/docs/cli/upgrade.mdx b/docs/cli/upgrade.mdxindex 2a66087c..17032281 100644--- a/docs/cli/upgrade.mdx+++ b/docs/cli/upgrade.mdx@@ -26,8 +26,8 @@ the explicit `beacon version check` command.Upgrade Beacon with the standard Homebrew flow:```bash title="Upgrade Beacon"-brew trust asymptote-labs/tapbrew update+brew trust asymptote-labs/tapbrew upgrade beaconbeacon version```@@ -147,7 +147,7 @@ Common states:| Symptom | What to check || --- | --- || `mode=off` or `Updater daemon: loaded=false` | Re-enable with `sudo /opt/beacon/bin/beacon endpoint update enable` or `--check-only`. |-| `homebrew_install` or `not_system_package` | The seamless updater applies only to the signed system package install. Use `brew upgrade beacon` for Homebrew. |+| `homebrew_install` or `not_system_package` | The seamless updater applies only to the signed system package install. Use `brew update && brew upgrade beacon` for Homebrew. || Manual non-root check cannot write `system.jsonl` | Run manual system checks with `sudo`, or rely on the root scheduled updater. || Package apply fails before install | Check checksum, signature, Gatekeeper, manifest URL, and network access to the package URL. || Package apply fails after install | Beacon should roll back and write `update.failed` to `system.jsonl`; inspect `/Library/Application Support/Beacon/Endpoint/updates/last_failure.json` if present. |diff --git a/docs/cli/version.mdx b/docs/cli/version.mdxindex 21aaa39e..f2001f0c 100644--- a/docs/cli/version.mdx+++ b/docs/cli/version.mdx@@ -14,7 +14,7 @@ beacon versionRunning `beacon` by itself in an interactive terminal also tells you when a newerrelease is out. When one is available, an orange notice shows the installed and latestversions, links to the [CLI changelog](/changelog/cli), and prints how to update for the-detected installation: `brew upgrade beacon` for Homebrew,+detected installation: `brew update && brew upgrade beacon` for Homebrew,`sudo beacon endpoint update --apply` for the system package, and the release downloadfor every other install (tarball, `install.sh`, `go install`, the Windows MSI, or asource build).@@ -54,7 +54,7 @@ When an update is available, Beacon prints the latest version, the installed ver$ beacon version checkBeacon v0.0.95 is available. Current version: v0.0.94-If installed with Homebrew: brew upgrade beacon+If installed with Homebrew: brew update && brew upgrade beaconDownload: https://github.com/asymptote-labs/agent-beacon/releases/tag/v0.0.95```</Accordion>@@ -74,8 +74,8 @@ Use `beacon version check` before upgrading to confirm whether a newer release i```bash title="Use beacon version check before upgrading to confirm whether a newer release is available"beacon version check-brew trust asymptote-labs/tapbrew update+brew trust asymptote-labs/tapbrew upgrade beacon```diff --git a/docs/deployment/hosting-options.mdx b/docs/deployment/hosting-options.mdxindex 6405a8a7..50b79299 100644--- a/docs/deployment/hosting-options.mdx+++ b/docs/deployment/hosting-options.mdx@@ -30,6 +30,7 @@ Use the open-source local path when you want endpoint telemetry without a hostedInstall Beacon with Homebrew:```bash+ brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/docs/deployment/open-source.mdx b/docs/deployment/open-source.mdxindex 793c714f..74cf358d 100644--- a/docs/deployment/open-source.mdx+++ b/docs/deployment/open-source.mdx@@ -12,6 +12,7 @@ Install Beacon on macOS, Windows, or Linux, configure the local endpoint telemetInstall Beacon with Homebrew:```bash+ brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacon@@ -100,8 +101,8 @@ Use the standard Homebrew upgrade flow, then reapply endpoint configuration if n```bash title="Upgrade Beacon"beacon version check-brew trust asymptote-labs/tapbrew update+brew trust asymptote-labs/tapbrew upgrade beaconbeacon endpoint repair```diff --git a/docs/get-started/quickstart.mdx b/docs/get-started/quickstart.mdxindex 399ef85f..59ad02de 100644--- a/docs/get-started/quickstart.mdx+++ b/docs/get-started/quickstart.mdx@@ -8,6 +8,7 @@ description: "Install Beacon, choose where your data lives, and capture your fir<Tabs><Tab title="macOS">```bash+ brew updatebrew trust asymptote-labs/tapbrew install asymptote-labs/tap/beacon```@@ -109,5 +110,5 @@ This shows which harnesses are connected, whether the collector is running, and| Open local dashboard | `beacon endpoint dashboard --open` || Connect to Beacon Cloud | `beacon endpoint connect` || Disconnect from Beacon Cloud | `beacon endpoint disconnect` |-| Upgrade | `brew upgrade beacon` |+| Upgrade | `brew update && brew upgrade beacon` || Uninstall | `beacon endpoint uninstall --keep-logs` |diff --git a/docs/guides/jamf-sentinel-mdm.mdx b/docs/guides/jamf-sentinel-mdm.mdxindex 138fadb2..9838edd6 100644--- a/docs/guides/jamf-sentinel-mdm.mdx+++ b/docs/guides/jamf-sentinel-mdm.mdx@@ -50,6 +50,7 @@ The Macs do not need Beacon installed beforehand. Jamf installs it in Policy 1.A Homebrew install lets you see what a session looks like before Jamf is involved. It stays on that Mac:```bash+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/docs/index.mdx b/docs/index.mdxindex 42fe0648..7d2ca432 100644--- a/docs/index.mdx+++ b/docs/index.mdx@@ -21,6 +21,7 @@ Use Beacon to understand agent behavior, debug workflows, and explicitly turn reInstall Beacon with Homebrew:```bash+ brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/docs/log-forwarding/datadog.mdx b/docs/log-forwarding/datadog.mdxindex 28da833c..41032891 100644--- a/docs/log-forwarding/datadog.mdx+++ b/docs/log-forwarding/datadog.mdx@@ -29,6 +29,7 @@ For production or MDM deployment, prefer **system mode**. It avoids per-user homFor local testing:```bash title="Set up local testing"+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/docs/log-forwarding/elastic.mdx b/docs/log-forwarding/elastic.mdxindex 2b762a9c..faba2c15 100644--- a/docs/log-forwarding/elastic.mdx+++ b/docs/log-forwarding/elastic.mdx@@ -39,6 +39,7 @@ Use system mode for MDM deployments so every managed endpoint writes to `/var/loFor a local macOS trial, install Beacon, configure endpoint telemetry, and start the bundled loopback-only stack:```bash title="Start the local Elastic validation stack"+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/docs/platforms/macos.mdx b/docs/platforms/macos.mdxindex 2abe7617..c264f693 100644--- a/docs/platforms/macos.mdx+++ b/docs/platforms/macos.mdx@@ -10,6 +10,7 @@ There are two ways in, and which one you want depends on whether you are setting## Your own machine```bash title="Install the CLI, then the endpoint"+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacon@@ -114,7 +115,7 @@ sudo beacon endpoint update --apply`--apply` downloads the release package, verifies its SHA-256 **and** its Apple notarization, installs it, restarts the collector, and rolls back if the new version fails its health check. The command reports which verification it performed, so a mixed fleet can tell the two platforms apart: macOS gets `sha256+notarization`, Linux gets `sha256` because there is no OS-level equivalent.-`--apply` requires a package install. A Homebrew install is upgraded with `brew upgrade beacon`.+`--apply` requires a package install. A Homebrew install is upgraded with `brew update && brew upgrade beacon`.## Uninstalldiff --git a/docs/runtimes/claude-code-cloud-agents.mdx b/docs/runtimes/claude-code-cloud-agents.mdxindex 20e7de5e..77e3d5ac 100644--- a/docs/runtimes/claude-code-cloud-agents.mdx+++ b/docs/runtimes/claude-code-cloud-agents.mdx@@ -73,6 +73,7 @@ s3://<bucket>/<prefix>/runtime/date=YYYY-MM-DD/<timestamp>-claude_code_web-<clauInstall or upgrade Beacon before you start:```bash+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/docs/runtimes/cursor-cloud-agents.mdx b/docs/runtimes/cursor-cloud-agents.mdxindex 5dc7d6ce..e79901a3 100644--- a/docs/runtimes/cursor-cloud-agents.mdx+++ b/docs/runtimes/cursor-cloud-agents.mdx@@ -80,6 +80,7 @@ that value instead.Install or upgrade Beacon before you start:```bash+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacondiff --git a/docs/runtimes/devin-cloud-agents.mdx b/docs/runtimes/devin-cloud-agents.mdxindex f023d3f9..4faeb7f4 100644--- a/docs/runtimes/devin-cloud-agents.mdx+++ b/docs/runtimes/devin-cloud-agents.mdx@@ -73,6 +73,7 @@ Beacon uses the Devin session id as the `run_id` and the Devin user id asInstall or upgrade Beacon:```bash+brew updatebrew trust asymptote-labs/tapbrew tap asymptote-labs/tapbrew install beacon