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
Default onboarding to Beacon Managed
Justin D'Souza598df6659157
diff --git a/CLAUDE.md b/CLAUDE.mdindex dcb5b545..f066f909 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -26,7 +26,7 @@ Do not recreate or depend on removed `asymptote` mirror trees. Keep new work foc- Preserve the local-only default. The public Beacon build must not require a hosted account, remote policy fetch, hosted dashboard, or external network dependency during normal hook execution, and hooks themselves never touch the network.- `beacon login` is the account-identity channel for interactive users and is required by the interactive `beacon endpoint install` wizard. It uses browser PKCE against beacon.sh, stores the scoped CLI token only in `~/.beacon/auth/session.json` (0600 under a 0700 directory), and is separate from endpoint enrollment: signing in alone never starts forwarding or sends telemetry. System/root/package/MDM/CI/piped-stdin/dry-run installs stay noninteractive and account-free. Keep account credentials out of endpoint config, hook environments, logs, and command output.- Asymptote Managed forwarding (`cli/beacon/internal/endpoint/asymptote`, `beacon endpoint connect`, `beacon endpoint asymptote`) is opt-in and Vector-shaped: Beacon writes local JSONL, Vector ships new lines after browser approval, and the `bcn_device_*` key stays only in `<BaseDir>/asymptote/vector-secrets.json` via Vector's secret backend. Keep the ingest URL `https://`, the wire contract aligned with `beacon-ingest` (`/v1/ingest/{runtime,inventory}` and `/v1/ingest/health`), and do not add another endpoint network channel. The cloud-sandbox shuttle is the bounded exception: only with `BEACON_ORIGIN=cloud`, it can upload new runtime lines to GCS, S3, or the same Asymptote ingest contract because no Vector/service manager/browser/persistent disk exists there.-- `beacon endpoint install` has a full-screen onboarding wizard on interactive user TTYs. It signs in, then offers Local (default) or Beacon Managed; Managed records intent and prints `beacon endpoint connect` as a separate next step, while explicit `install --connect` still enrolls after installation. The wizard is skipped for system/root/CI/piped-stdin/dry-run or `BEACON_ONBOARDING=0`; those unattended paths must never gain an account or browser dependency. Legacy `BEACON_ONBOARDING_EMAIL`/`USAGE` submissions remain only for fleet compatibility. Implementation lives in `cli/beacon/internal/onboarding` and `cli/beacon/cmd/endpoint_onboarding.go`; keep `docs/cli/endpoint-onboarding.mdx` in sync.+- `beacon endpoint install` has a full-screen onboarding wizard on interactive user TTYs. It signs in, then preselects Beacon Managed and requires an explicit choice to opt out to Local; accepting Managed still only records intent and prints `beacon endpoint connect`, so no telemetry moves during onboarding. Explicit `install --connect` still enrolls after installation. The wizard is skipped for system/root/CI/piped-stdin/dry-run or `BEACON_ONBOARDING=0`; those unattended paths must never gain an account or browser dependency. Legacy `BEACON_ONBOARDING_EMAIL`/`USAGE` submissions remain only for fleet compatibility. Implementation lives in `cli/beacon/internal/onboarding` and `cli/beacon/cmd/endpoint_onboarding.go`; keep `docs/cli/endpoint-onboarding.mdx` in sync.- Do not add dependency vulnerability scanning, OSV/GHSA lookups, package remediation, or other vulnerability-enforcement flows to the public hook path.- Do not add broad runtime enforcement unless explicitly requested. Current control behavior is limited to hook-native approvals/denials exposed by supported agent runtimes.- Keep destination support shaped like the existing local JSONL and customer-managed forwarding paths. Beacon may render supported packs or token-based endpoint forwarders, but should not add hosted SIEM dependencies or store third-party service credentials beyond the explicit supported configs. Elastic remains a file-tailing pack over local JSONL.diff --git a/README.md b/README.mdindex f7f6a717..2d0aa1ff 100644--- a/README.md+++ b/README.md@@ -46,8 +46,9 @@ Beacon is an open-source memory layer for AI coding agents that learns from your## 🚀 Quick StartBeacon is open source and local-first. Interactive endpoint setup signs in through-beacon.sh, then defaults to keeping telemetry on the machine. System, package, MDM,-and CI installation paths remain noninteractive and account-free.+beacon.sh and preselects Beacon Managed, with an explicit Local opt-out. Nothing is+forwarded until the separate connect step. System, package, MDM, and CI installation+paths remain noninteractive and account-free.### 1. Install Beacondiff --git a/cli/beacon/cmd/endpoint_onboarding_test.go b/cli/beacon/cmd/endpoint_onboarding_test.goindex f4e302d3..6f9009a0 100644--- a/cli/beacon/cmd/endpoint_onboarding_test.go+++ b/cli/beacon/cmd/endpoint_onboarding_test.go@@ -118,6 +118,9 @@ func newOnboardingHarness(t *testing.T) *onboardingHarness {}if destination == "" {destination = onboarding.DestinationLocal+ if opts.OfferManaged {+ destination = onboarding.DestinationAsymptote+ }}return onboarding.WizardResult{Completed: true, Destination: destination}, nil}@@ -170,9 +173,12 @@ func TestMaybeRunOnboardingPromptsOnInteractiveInstall(t *testing.T) {}if h.saved[0].Onboarding.Outcome != onboarding.OutcomeAuthenticated ||h.saved[0].Onboarding.Email != "[email protected]" ||- h.saved[0].Onboarding.Destination != onboarding.DestinationLocal {+ h.saved[0].Onboarding.Destination != onboarding.DestinationAsymptote {t.Fatalf("saved account onboarding = %+v", h.saved[0].Onboarding)}+ if !strings.Contains(h.stdout.String(), "beacon endpoint connect") {+ t.Fatalf("managed next step missing: %s", h.stdout.String())+ }if h.saved[0].InstallID == "" {t.Fatalf("saved profile has no install ID")}diff --git a/cli/beacon/internal/onboarding/wizard.go b/cli/beacon/internal/onboarding/wizard.goindex 6c842b0f..e48c924b 100644--- a/cli/beacon/internal/onboarding/wizard.go+++ b/cli/beacon/internal/onboarding/wizard.go@@ -143,11 +143,10 @@ func (m wizardModel) advance() (tea.Model, tea.Cmd) {}func (m wizardModel) destinations() []string {- destinations := []string{DestinationLocal}if m.options.OfferManaged {- destinations = append(destinations, DestinationAsymptote)+ return []string{DestinationAsymptote, DestinationLocal}}- return destinations+ return []string{DestinationLocal}}func (m wizardModel) View() string {@@ -205,9 +204,9 @@ func (m wizardModel) View() string {func destinationCopy(destination string) (string, string) {switch destination {case DestinationAsymptote:- return "Beacon Managed", "Keep local JSONL and optionally forward new events to beacon.sh."+ return "Beacon Managed (recommended)", "Keep local JSONL and forward new events after you connect."default:- return "Local only", "Nothing is sent anywhere. Browse with `beacon traces` or the local dashboard."+ return "Local only", "Opt out of managed forwarding. Nothing is sent anywhere."}}diff --git a/cli/beacon/internal/onboarding/wizard_test.go b/cli/beacon/internal/onboarding/wizard_test.goindex d4cf52b7..c7206692 100644--- a/cli/beacon/internal/onboarding/wizard_test.go+++ b/cli/beacon/internal/onboarding/wizard_test.go@@ -40,7 +40,7 @@ func TestWizardRequestsLoginBeforeDestination(t *testing.T) {}}-func TestSignedInWizardDefaultsToLocalAndCompletes(t *testing.T) {+func TestSignedInWizardCanOptOutToLocal(t *testing.T) {model := newWizardModel(WizardOptions{SignedIn: true,Email: "[email protected]",@@ -51,6 +51,10 @@ func TestSignedInWizardDefaultsToLocalAndCompletes(t *testing.T) {if model.screen != destinationScreen {t.Fatalf("screen = %v, want destination", model.screen)}+ if got := model.destinations(); len(got) != 2 || got[0] != DestinationAsymptote || got[1] != DestinationLocal {+ t.Fatalf("destination order = %#v", got)+ }+ model, _ = advanceWizard(t, model, "j")model, _ = advanceWizard(t, model, "enter")if model.screen != confirmScreen || model.result.Destination != DestinationLocal {t.Fatalf("local selection = screen %v result %#v", model.screen, model.result)@@ -72,7 +76,6 @@ func TestManagedWizardRequiresDisclosureConfirmation(t *testing.T) {DestinationOnly: true,})model.width, model.height = 100, 30- model, _ = advanceWizard(t, model, "j")model, _ = advanceWizard(t, model, "enter")if model.screen != managedDisclosureScreen || model.result.Destination != DestinationAsymptote {t.Fatalf("managed selection = screen %v result %#v", model.screen, model.result)diff --git a/docs/cli/endpoint-install.mdx b/docs/cli/endpoint-install.mdxindex 4bc8237a..eaf08ce5 100644--- a/docs/cli/endpoint-install.mdx+++ b/docs/cli/endpoint-install.mdx@@ -54,8 +54,8 @@ signs in through beacon.sh, then asks where this machine's telemetry should go:| Answer | What happens ||--------|--------------|-| Keep it on this machine (default) | Nothing is forwarded. Enter picks this, so forwarding is never a side effect. |-| Beacon Managed | Shows what will be sent, records the choice, and prints `beacon endpoint connect` as a separate next step. Nothing is forwarded during the wizard. |+| Beacon Managed (default) | Shows what will be sent, records the choice, and prints `beacon endpoint connect` as a separate next step. Nothing is forwarded during the wizard. |+| Local only | Explicitly opts out of managed forwarding. Nothing is sent anywhere. |`--connect` presets Beacon Managed and runs the connect flow after installation.`BEACON_MANAGED_INGEST=0` hides the managed answer. The wizard is never showndiff --git a/docs/cli/endpoint-onboarding.mdx b/docs/cli/endpoint-onboarding.mdxindex 93a7543c..8399275a 100644--- a/docs/cli/endpoint-onboarding.mdx+++ b/docs/cli/endpoint-onboarding.mdx@@ -24,7 +24,8 @@ The first interactive `beacon endpoint install` opens a full-screen terminal wiz3. Review the destination and confirm installation.Signing in establishes account identity only. It does not register a managed endpoint,-start Vector, or send telemetry. Local is the default selection.+start Vector, or send telemetry. Beacon Managed is preselected; choose Local explicitly+to opt out of managed forwarding.Choosing Beacon Managed shows a separate disclosure that new runtime and inventoryevents will be sent to beacon.sh only after you run: