Skip to content

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

Say less, and say what the choice actually decides

shukieshah42244121e8ad
diff --git a/cli/beacon/cmd/endpoint_destinations.go b/cli/beacon/cmd/endpoint_destinations.go
index 876db54f..164cc6af 100644
--- a/cli/beacon/cmd/endpoint_destinations.go
+++ b/cli/beacon/cmd/endpoint_destinations.go
@@ -331,7 +331,9 @@ var siemDestinations = []siemDestination{
print: func(cfg endpointconfig.Config) {
fmt.Println("Expected Asymptote fields: vendor=beacon product=endpoint-agent destination.type=asymptote destination.mode=asymptote_managed_http")
fmt.Println(`Check the device key: curl -sS -o /dev/null -w '%{http_code}\n' "$BEACON_ASYMPTOTE_INGEST_URL/v1/ingest/health" -H "Authorization: Bearer $(sed -n 's/.*\"device_key\": *\"\([^\"]*\)\".*/\1/p' "$BEACON_ASYMPTOTE_SECRETS_FILE")" # 200 valid, 401 revoked`)
- fmt.Println("Confirm delivery on the Asymptote dashboard telemetry page by searching for \"Beacon endpoint Asymptote validation event\"; forwarded events appear within a minute or two.")
+ // Points at the dashboard itself: its views are tabs, so there is no
+ // /dashboard/telemetry route to send anyone to.
+ fmt.Printf("Confirm delivery at %s by searching for \"Beacon endpoint Asymptote validation event\"; forwarded events appear within a minute or two.\n", dashboardHomeURL(""))
},
},
},
diff --git a/cli/beacon/internal/onboarding/wizard.go b/cli/beacon/internal/onboarding/wizard.go
index bf385030..b0f98493 100644
--- a/cli/beacon/internal/onboarding/wizard.go
+++ b/cli/beacon/internal/onboarding/wizard.go
@@ -488,7 +488,7 @@ func (m wizardModel) View() string {
switch m.screen {
case welcomeScreen:
title = "Welcome to Beacon"
- body = "One local timeline for every AI agent.\n\nThis interactive setup signs you in, then asks whether telemetry should stay local or be forwarded to Beacon Managed."
+ body = "Interactive setup: sign in, choose where this machine's telemetry goes, and install."
if m.options.SignedIn {
body += "\n\n" + wizardDim.Render("Signed in as "+m.options.Email)
}
@@ -497,11 +497,10 @@ func (m wizardModel) View() string {
// --no-browser means no browser will be opened, so promising one here sends
// an SSH or headless user looking for a window that never appears.
if m.options.NoBrowser {
- body = "Beacon will show a beacon.sh URL to open yourself, using a secure PKCE flow."
+ body = "Beacon will show a beacon.sh URL for you to open."
} else {
- body = "Beacon will open beacon.sh in your browser using a secure PKCE flow."
+ body = "Beacon will open beacon.sh in your browser."
}
- body += "\n\nSigning in does not send telemetry, register a managed endpoint, or enable forwarding."
case signInWaitScreen:
title = "Waiting for you to finish signing in"
switch {
@@ -516,8 +515,7 @@ func (m wizardModel) View() string {
}
raw = m.prompt.URL
if m.prompt.URL != "" {
- raw += "\n\n" + wizardDim.Render(m.waitStatus()) +
- "\n\n" + wizardDim.Render("Signing in does not send telemetry or connect this machine.")
+ raw += "\n\n" + wizardDim.Render(m.waitStatus())
}
case signInFailedScreen:
title = "Sign-in did not finish"
@@ -547,10 +545,12 @@ func (m wizardModel) View() string {
}
body = strings.Join(rows, "\n")
case managedDisclosureScreen:
- title = "Beacon Managed sends new telemetry to beacon.sh"
- body = wizardWarn.Render("Nothing is forwarded by signing in.") +
- "\n\nBeacon installs, then connects this machine: a device key is minted and a local Vector forwarder starts sending new events to beacon.sh over HTTPS." +
- "\n\nRuntime events recorded before you connect stay on this machine. The inventory snapshot -- which agent runtimes, skills, and MCP servers are installed here -- uploads once so the dashboard has this endpoint's baseline." +
+ title = "What gets sent to beacon.sh"
+ body = "From now on, what your agents do on this machine is sent to your Beacon " +
+ "account as it happens. You choose how much of it on the next screen." +
+ "\n\nWhat is already on this machine stays here. The one exception is a list of " +
+ "which agents and tools you have installed, sent once so the dashboard knows " +
+ "what this machine is." +
"\n\nStop any time with `beacon endpoint disconnect`."
case privacyScreen:
title = "Choose what Beacon Managed receives"
@@ -573,13 +573,14 @@ func (m wizardModel) View() string {
body += "Destination: " + label
if m.result.Destination == DestinationAsymptote {
body += "\nPrivacy: " + managedprivacy.Label(m.result.PrivacyMode) +
- "\n\n" + wizardWarn.Render("Confirming installs Beacon and starts forwarding new events to beacon.sh.") +
- "\n\n" + privacySends(m.result.PrivacyMode)
+ "\n\n" + wizardWarn.Render("This installs Beacon and starts forwarding to beacon.sh.") +
+ "\n" + wizardDim.Render(privacySends(m.result.PrivacyMode))
} else {
body += "\n\nYour telemetry stays on this machine."
if m.result.WithoutAccount {
body += " You are not signed in; connect later with `beacon endpoint connect`."
}
+
}
}
@@ -599,12 +600,14 @@ func destinationCopy(destination string) (string, string) {
switch destination {
case DestinationAsymptote:
return "Beacon Managed (recommended)",
- "One searchable history across Claude Code, Cursor, Codex and more. " +
- "Unlimited retention, token and usage analytics. No backend to run."
+ "The full Beacon dashboard: search across every session, analytics, findings " +
+ "and detections, every machine in one place, kept indefinitely and safe if " +
+ "this one is lost. Pick this to actually use Beacon."
default:
return "Local only",
- "Everything stays in ~/.beacon on this machine. You manage retention, " +
- "and history is limited to this device."
+ "A basic dashboard on this machine: recent sessions and traces, this machine " +
+ "only, for as long as the logs are on disk. Nothing leaves. Pick this to " +
+ "explore Beacon or to keep data off the network."
}
}
@@ -627,9 +630,9 @@ func choiceDetail(detail string, width int) string {
func privacyCopy(mode string) (string, string) {
if mode == managedprivacy.MetadataOnly {
- return "Metadata only", "Omit prompts, responses, reasoning, tool arguments/results, command output, raw fields, and diffs."
+ return "Metadata only", "No prompts, responses, tool arguments or results, command output, or diffs."
}
- return "Standard (recommended)", "Send locally sanitized retained content, including prompts and tool activity."
+ return "Standard (recommended)", "Locally sanitized content, including prompts and tool activity."
}
func privacyIndex(mode string) int {
@@ -646,9 +649,9 @@ func privacyIndex(mode string) int {
// leaves this machine rather than point at a command to run later.
func privacySends(mode string) string {
if mode == managedprivacy.MetadataOnly {
- return "Metadata only: prompts, responses, reasoning, tool arguments and results, command output and diffs stay on this machine."
+ return "Prompts, responses, tool arguments and results, command output and diffs stay here."
}
- return "Standard: the locally sanitized event, including prompts and tool activity."
+ return "Sends locally sanitized content, including prompts and tool activity."
}
// waitStatus renders the spinner, how long this has been going, and how long is
diff --git a/cli/beacon/internal/onboarding/wizard_test.go b/cli/beacon/internal/onboarding/wizard_test.go
index a26cea68..9f5420a6 100644
--- a/cli/beacon/internal/onboarding/wizard_test.go
+++ b/cli/beacon/internal/onboarding/wizard_test.go
@@ -34,8 +34,8 @@ func TestWizardRequestsLoginBeforeDestination(t *testing.T) {
if model.screen != signInScreen {
t.Fatalf("screen = %v, want sign in", model.screen)
}
- if view := model.View(); !strings.Contains(view, "does not send telemetry") {
- t.Fatalf("sign-in disclosure missing:\n%s", view)
+ if view := model.View(); !strings.Contains(view, "beacon.sh") {
+ t.Fatalf("sign-in screen should name where it sends you:\n%s", view)
}
model, command := advanceWizard(t, model, "enter")
if command == nil || !model.result.NeedLogin || model.result.Completed {
@@ -85,18 +85,17 @@ func TestManagedWizardRequiresDisclosureConfirmation(t *testing.T) {
}
view := strings.Join(strings.Fields(model.View()), " ")
for _, want := range []string{
- "sends new telemetry to beacon.sh",
- "Nothing is forwarded by signing in",
- // Confirming now connects, so the disclosure describes that rather than
- // naming a command the user is expected to run afterwards.
- "Beacon installs, then connects this machine",
+ // Plain language: what is sent, what is not, and how to stop. No mention of
+ // the forwarder's implementation, which nobody choosing a destination needs.
+ "What gets sent to beacon.sh",
+ "sent to your Beacon account as it happens",
+ "What is already on this machine stays here",
+ "which agents and tools you have installed",
"beacon endpoint disconnect",
// The disclosure has to describe what actually ships. The runtime source is
// read_from = "end", so pre-connect runtime events stay local -- but the
// inventory source is read_from = "beginning", so the existing snapshot does
// upload. The screen used to flatly claim nothing existing is uploaded.
- "Runtime events recorded before you connect stay on this machine",
- "inventory snapshot",
} {
if !strings.Contains(view, want) {
t.Fatalf("managed disclosure missing %q:\n%s", want, view)
@@ -105,6 +104,11 @@ func TestManagedWizardRequiresDisclosureConfirmation(t *testing.T) {
if strings.Contains(view, "Existing local history is not uploaded") {
t.Fatalf("the disclosure must not claim existing history is never uploaded; inventory is:\n%s", view)
}
+ for _, jargon := range []string{"Vector", "HTTPS", "forwarder", "snapshot"} {
+ if strings.Contains(view, jargon) {
+ t.Fatalf("the disclosure should not need %q to be understood:\n%s", jargon, view)
+ }
+ }
model, _ = advanceWizard(t, model, "enter")
if model.screen != privacyScreen {
t.Fatalf("screen = %v, want privacy", model.screen)
@@ -174,23 +178,32 @@ func TestDestinationCaptionsNameTheValueNotTheMechanism(t *testing.T) {
if !strings.Contains(managedLabel, "Beacon Managed") {
t.Fatalf("managed label = %q", managedLabel)
}
- for _, want := range []string{"searchable", "Unlimited retention", "analytics"} {
+ for _, want := range []string{"full Beacon dashboard", "search", "analytics", "indefinitely", "Pick this"} {
if !strings.Contains(managedDetail, want) {
t.Fatalf("managed detail missing %q: %q", want, managedDetail)
}
}
+
localLabel, localDetail := destinationCopy(DestinationLocal)
if !strings.Contains(localLabel, "Local only") {
t.Fatalf("local label = %q", localLabel)
}
- // Local is a supported end state, not a penalty: it says where data lives and
- // what the user takes on, and does not editorialize.
- if !strings.Contains(localDetail, "stays in ~/.beacon") {
- t.Fatalf("local detail should say where data lives: %q", localDetail)
+ // Local is a supported end state, not a penalty, and it is not feature-poor:
+ // the local dashboard ships the same Findings, Detections, Analytics and Token
+ // Usage views. Claiming Managed adds those would be false, so the copy has to
+ // differentiate on scope, retention and durability instead.
+ for _, want := range []string{"this machine", "Nothing leaves", "explore Beacon", "Pick this"} {
+ if !strings.Contains(localDetail, want) {
+ t.Fatalf("local detail missing %q: %q", want, localDetail)
+ }
+ }
+ if strings.Contains(localDetail, "Opt out") {
+ t.Fatalf("local should read as a peer choice, not a refusal: %q", localDetail)
}
- for _, unwanted := range []string{"Opt out", "Nothing is sent"} {
- if strings.Contains(localDetail, unwanted) {
- t.Fatalf("local detail should read as a peer choice, found %q: %q", unwanted, localDetail)
+ // Both say when to choose them, which is the part a first-time user needs.
+ for name, detail := range map[string]string{"managed": managedDetail, "local": localDetail} {
+ if !strings.Contains(detail, "Pick this") {
+ t.Fatalf("%s detail gives no guidance on when to choose it: %q", name, detail)
}
}
}
@@ -219,7 +232,7 @@ func TestChoiceDetailIndentsEveryWrappedLine(t *testing.T) {
// And the whole screen still renders every word of both captions.
view := strings.Join(strings.Fields(model.View()), " ")
- for _, want := range []string{"No backend to run.", "limited to this device."} {
+ for _, want := range []string{"Pick this to actually use Beacon.", "keep data off the network."} {
if !strings.Contains(view, want) {
t.Fatalf("destination screen truncated %q:\n%s", want, view)
}
@@ -253,7 +266,7 @@ func TestWizardHasNoGlobalQuitKey(t *testing.T) {
func TestConfirmScreenNamesWhatConfirmingStarts(t *testing.T) {
for mode, wantSends := range map[string]string{
"standard": "including prompts and tool activity",
- "metadata_only": "stay on this machine",
+ "metadata_only": "stay here",
} {
model := newWizardModel(WizardOptions{
SignedIn: true,
@@ -270,7 +283,7 @@ func TestConfirmScreenNamesWhatConfirmingStarts(t *testing.T) {
view := strings.Join(strings.Fields(model.View()), " ")
for _, want := range []string{
- "Confirming installs Beacon and starts forwarding new events to beacon.sh.",
+ "This installs Beacon and starts forwarding to beacon.sh.",
wantSends,
"enter install and connect",
} {
@@ -358,7 +371,7 @@ func TestSignInWaitShowsAnUnwrappedURLAndAClock(t *testing.T) {
t.Fatalf("the sign-in URL must render on one unbroken line:\n%s", view)
}
flat := strings.Join(strings.Fields(view), " ")
- for _, want := range []string{"0:07 elapsed", "times out in 4:53", "does not send telemetry"} {
+ for _, want := range []string{"0:07 elapsed", "times out in 4:53"} {
if !strings.Contains(flat, want) {
t.Fatalf("waiting screen missing %q:\n%s", want, view)
}
@@ -629,7 +642,7 @@ func TestSignInScreenHonorsNoBrowser(t *testing.T) {
if strings.Contains(view, "will open beacon.sh in your browser") {
t.Fatalf("--no-browser screen still promises to open a browser:\n%s", view)
}
- for _, want := range []string{"URL to open yourself", "enter show the sign-in URL"} {
+ for _, want := range []string{"URL for you to open", "enter show the sign-in URL"} {
if !strings.Contains(view, want) {
t.Fatalf("--no-browser screen missing %q:\n%s", want, view)
}
diff --git a/docs/changelog/cli.mdx b/docs/changelog/cli.mdx
index dfcc91e0..1af8f38c 100644
--- a/docs/changelog/cli.mdx
+++ b/docs/changelog/cli.mdx
@@ -13,6 +13,15 @@ Stay up to date with the latest changes to the Agent Beacon CLI.
### Unreleased
+- **Plainer onboarding copy** · The wizard explained itself twice and repeated the
+ same reassurance on three screens. The welcome now states what interactive setup
+ does in one line, and the screens that follow say only what that screen decides.
+ The destination choice describes what you actually get from each: Managed as the
+ full dashboard with search, analytics, findings and detections across every
+ machine and kept indefinitely, Local as a basic single-machine dashboard for
+ exploring Beacon or keeping data off the network, each saying when to pick it.
+ The managed disclosure is plain language, with no forwarder internals.
+
- **Printed dashboard links point somewhere that exists** · The dashboard is a
single page at `/dashboard` whose views are tabs, so the service root serves the
marketing site and deep links such as `/dashboard/telemetry` and
diff --git a/docs/cli/endpoint-onboarding.mdx b/docs/cli/endpoint-onboarding.mdx
index f20829eb..69ba9f11 100644
--- a/docs/cli/endpoint-onboarding.mdx
+++ b/docs/cli/endpoint-onboarding.mdx
@@ -20,10 +20,11 @@ Beacon does not repeat completed setup.
The first interactive `beacon endpoint install` opens a full-screen terminal wizard:
1. Sign in through beacon.sh using the same browser PKCE flow as [`beacon login`](/cli/account-auth).
-2. Choose **Local only** or **Beacon Managed**. Managed is described by what it adds:
- one searchable history across every agent, unlimited retention, token and usage
- analytics, and no backend to run. Local keeps everything in `~/.beacon` on the
- machine, where you manage retention and history covers only that device.
+2. Choose **Local only** or **Beacon Managed**. Managed is the full dashboard:
+ search across every session, analytics, findings and detections, every machine
+ in one place, kept indefinitely. Local is a basic dashboard on the machine
+ itself, covering only that machine for as long as the logs are on disk, and is
+ framed for exploring Beacon or keeping data off the network.
3. For Managed, choose **Standard** or **Metadata only** forwarding.
4. Review the destination and privacy mode, then confirm installation.