Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

Default onboarding to Beacon Managed

Justin D'Souza598df6659157
diff --git a/CLAUDE.md b/CLAUDE.md
index 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.md
index 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 Start
Beacon 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 Beacon
diff --git a/cli/beacon/cmd/endpoint_onboarding_test.go b/cli/beacon/cmd/endpoint_onboarding_test.go
index 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.go
index 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.go
index 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,
@@ -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.mdx
index 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 shown
diff --git a/docs/cli/endpoint-onboarding.mdx b/docs/cli/endpoint-onboarding.mdx
index 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 wiz
3. 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 inventory
events will be sent to beacon.sh only after you run: