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
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.goindex 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.goindex 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.URLif 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: " + labelif 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 isdiff --git a/cli/beacon/internal/onboarding/wizard_test.go b/cli/beacon/internal/onboarding/wizard_test.goindex 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.mdxindex 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 asingle page at `/dashboard` whose views are tabs, so the service root serves themarketing site and deep links such as `/dashboard/telemetry` anddiff --git a/docs/cli/endpoint-onboarding.mdx b/docs/cli/endpoint-onboarding.mdxindex 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.