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
update onboarding flow
Justin D'Souzac4409149d044
diff --git a/README.md b/README.mdindex 1a18f3ff..63b60d30 100644--- a/README.md+++ b/README.md@@ -159,10 +159,10 @@ Or inspect the raw event stream:> [!NOTE]> Signing in does not enable forwarding. Confirming the preselected Beacon Cloud-> option does: the wizard says so on the confirm screen, names what your chosen-> privacy mode sends, and connects the endpoint after the install succeeds. Choose-> Local to keep everything on this machine, and disconnect any time with-> `beacon endpoint disconnect`.+> option does: the confirm screen names Asymptote Labs as the operator, the+> destination, and the capture mode, and connects the endpoint after the install+> succeeds. Choose Local to keep everything on this machine, and disconnect any+> time with `beacon endpoint disconnect`.Whichever destination you choose, the wizard also installs the[Beacon Skills](https://docs.beacon.sh/concepts/beacon-skills) into `~/.agents/skills`diff --git a/cli/beacon/internal/onboarding/wizard.go b/cli/beacon/internal/onboarding/wizard.goindex 4636c988..c0c5838b 100644--- a/cli/beacon/internal/onboarding/wizard.go+++ b/cli/beacon/internal/onboarding/wizard.go@@ -694,7 +694,8 @@ func (m wizardModel) View() string {}rows = append(rows, line, choiceDetail(detail, contentWidth))}- body = strings.Join(rows, "\n")+ body = strings.Join(rows, "\n") ++ "\n\nChange later with `beacon endpoint connect --privacy-mode`."case agentToolsScreen:title = "Set up your agents"body = "Give your agents their own history.\n\n"@@ -714,19 +715,28 @@ func (m wizardModel) View() string {body += strings.Join(rows, "\n")case confirmScreen:title = "Ready to set up Beacon"- label, _ := destinationCopy(m.result.Destination)- if m.options.Email != "" {- body = "Account: " + m.options.Email + "\n"- }- body += "Destination: " + labelif m.result.Destination == DestinationAsymptote {- body += "\nPrivacy: " + managedprivacy.Label(m.result.PrivacyMode) +- "\n\n" + wizardWarn.Render("This installs Beacon and starts forwarding to beacon.sh.") +- "\n" + wizardDim.Render(privacySends(m.result.PrivacyMode))+ // Values share a column: "Destination:" is one character shorter than+ // "Capture mode:", so it takes one more space.+ body = "Beacon Cloud is operated by Asymptote Labs, Inc." ++ "\n\n" ++ " Destination: Beacon Cloud\n" ++ " Capture mode: " + managedprivacy.Label(m.result.PrivacyMode) ++ "\n\n" ++ "Turn off research and AI training any time in Beacon Cloud:\n" ++ "click your profile picture (top right), then Settings.\n" ++ "Change capture mode any time with `beacon endpoint connect --privacy-mode`.\n" ++ "Stop sending any time with `beacon endpoint disconnect`.\n" ++ "To delete your data, email [email protected]."if m.options.BackfillDays > 0 {- body += "\n" + wizardDim.Render(fmt.Sprintf("It also uploads your agent sessions from the last %d days, read from their session history on this machine.", m.options.BackfillDays))+ body += "\n\n" + fmt.Sprintf("It also uploads your agent sessions from the last %d days, read from their session history on this machine.", m.options.BackfillDays)}} else {+ label, _ := destinationCopy(m.result.Destination)+ if m.options.Email != "" {+ body = "Account: " + m.options.Email + "\n"+ }+ body += "Destination: " + labelbody += "\n\nYour telemetry stays on this machine."if m.options.BackfillDays > 0 {body += fmt.Sprintf(" Beacon reads your agent sessions from the last %d days into its local log.", m.options.BackfillDays)@@ -793,17 +803,18 @@ func destinationCopy(destination string) (string, string) {switch destination {case DestinationAsymptote:return "Beacon Cloud (recommended)",- "Free, unlimited cloud-based retention of all your agent sessions. " ++ "Your agent sessions are sent to your Beacon account and kept in the cloud " ++ "while your account is active. Includes " +// Non-breaking hyphen: the wrapper treats a plain "-" as a break// point and split this across lines as "AI-" / "powered"."AI\u2011powered search and analytics on Beacon's hosted dashboard. " +- "Rich findings analyzing your AI usage, coming soon. " +- "Pick this for Beacon's full feature set."+ "Pick this for Beacon's full feature set. " ++ "Unless you opt out, Asymptote uses your sessions for research and AI " ++ "training and may share de-identified data. Details: beacon.sh/privacy"default:return "Local only",- "A local dashboard for this machine's agent telemetry, kept for as long as " +- "the logs are on disk. Nothing leaves your machine. Pick this for " +- "testing, or to just see your agent activity in one place."+ "A local dashboard for this machine's agent activity, kept for as long as " ++ "the logs are on disk. Your agent activity stays on this machine."}}@@ -826,9 +837,20 @@ func choiceDetail(detail string, width int) string {func privacyCopy(mode string) (string, string) {if mode == managedprivacy.MetadataOnly {- return "Metadata only", "No prompts, responses, tool arguments or results, command output, or diffs."- }- return "Standard (recommended)", "Locally sanitized content, including prompts and tool activity."+ return "Metadata only",+ "Prompts, responses, reasoning, tool arguments and results, command output, " ++ "file diffs, and file contents are removed on your machine before anything " ++ "is sent. Only structural information is sent: which agent and tool ran, " ++ "file paths, exit codes, token counts, timestamps, repository and branch " ++ "names, and full command lines. Common secret formats in command lines are " ++ "also masked."+ }+ return "Standard",+ "Prompts, responses, tool activity, command output, file diffs, and file " ++ "contents returned by tools. Common secret formats, such as API keys and " ++ "tokens, are masked on your machine before anything is sent. Masking is " ++ "pattern-based and may not catch everything. May include source code, file " ++ "contents, and confidential information."}func privacyIndex(mode string) int {@@ -840,16 +862,6 @@ func privacyIndex(mode string) int {return 0}-// privacySends states, in the present tense, what the selected mode puts on the-// wire. The confirm screen is where forwarding is authorized, so it has to name what-// leaves this machine rather than point at a command to run later.-func privacySends(mode string) string {- if mode == managedprivacy.MetadataOnly {- return "Prompts, responses, tool arguments and results, command output and diffs stay here."- }- return "Sends locally sanitized content, including prompts and tool activity."-}-// waitStatus renders the spinner, how long this has been going, and how long is// left, so a wait with no visible progress is not mistaken for a hang.func (m wizardModel) waitStatus() string {diff --git a/cli/beacon/internal/onboarding/wizard_test.go b/cli/beacon/internal/onboarding/wizard_test.goindex 14613541..bd476dd2 100644--- a/cli/beacon/internal/onboarding/wizard_test.go+++ b/cli/beacon/internal/onboarding/wizard_test.go@@ -120,8 +120,24 @@ func TestManagedWizardRequiresDisclosureConfirmation(t *testing.T) {if model.screen != privacyScreen {t.Fatalf("screen = %v, want privacy", model.screen)}- if view := model.View(); !strings.Contains(view, "Standard (recommended)") || !strings.Contains(view, "Metadata only") {- t.Fatalf("privacy choices missing:\n%s", view)+ view = strings.Join(strings.Fields(model.View()), " ")+ for _, want := range []string{+ "Standard",+ "Metadata only",+ "file contents returned by tools",+ "Masking is pattern-based and may not catch everything",+ "May include source code, file contents, and confidential information",+ "Only structural information is sent",+ "full command lines",+ "Common secret formats in command lines are also masked",+ "beacon endpoint connect --privacy-mode",+ } {+ if !strings.Contains(view, want) {+ t.Fatalf("privacy screen missing %q:\n%s", want, view)+ }+ }+ if strings.Contains(view, "Standard (recommended)") {+ t.Fatalf("privacy screen still marks Standard as recommended:\n%s", view)}model, _ = advanceWizard(t, model, "enter")if model.screen != confirmScreen {@@ -185,7 +201,13 @@ func TestDestinationCaptionsNameTheValueNotTheMechanism(t *testing.T) {if !strings.Contains(managedLabel, "Beacon Cloud") {t.Fatalf("managed label = %q", managedLabel)}- for _, want := range []string{"Free, unlimited cloud-based retention", "AI\u2011powered search and analytics on Beacon's hosted dashboard", "Rich findings analyzing your AI usage, coming soon.", "full feature set"} {+ for _, want := range []string{+ "sent to your Beacon account and kept in the cloud while your account is active",+ "AI\u2011powered search and analytics on Beacon's hosted dashboard",+ "full feature set",+ "Unless you opt out, Asymptote uses your sessions for research and AI training and may share de-identified data",+ "Details: beacon.sh/privacy",+ } {if !strings.Contains(managedDetail, want) {t.Fatalf("managed detail missing %q: %q", want, managedDetail)}@@ -195,23 +217,19 @@ func TestDestinationCaptionsNameTheValueNotTheMechanism(t *testing.T) {if !strings.Contains(localLabel, "Local only") {t.Fatalf("local label = %q", localLabel)}- // 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 Beacon Cloud 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 your machine", "testing", "agent activity in one place"} {+ // Local is a supported end state, not a refusal of Beacon Cloud. The research+ // and training disclosure belongs on the cloud caption, where the data leaves+ // the machine.+ for _, want := range []string{"this machine's agent activity", "kept for as long as the logs are on disk", "Your agent activity stays on this machine"} {if !strings.Contains(localDetail, want) {t.Fatalf("local detail missing %q: %q", want, localDetail)}}- if strings.Contains(localDetail, "Opt out") {+ if strings.Contains(localDetail, "opt out") || strings.Contains(localDetail, "research") {t.Fatalf("local should read as a peer choice, not a refusal: %q", 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)- }+ if !strings.Contains(managedDetail, "Pick this") {+ t.Fatalf("managed detail gives no guidance on when to choose it: %q", managedDetail)}}@@ -239,7 +257,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{"full feature set.", "agent activity in one place."} {+ for _, want := range []string{"full feature set.", "beacon.sh/privacy", "Your agent activity stays on this machine."} {if !strings.Contains(view, want) {t.Fatalf("destination screen truncated %q:\n%s", want, view)}@@ -267,13 +285,13 @@ func TestWizardHasNoGlobalQuitKey(t *testing.T) {}}-// The confirm screen is where forwarding is authorized, so it has to name the-// action. It used to say "Next step after install: beacon endpoint connect", which-// stopped being true once confirming did the connecting.+// The confirm screen is where forwarding is authorized. It names the operator,+// the destination, the capture mode, and how to opt out, change the mode, stop+// sending, or delete the data.func TestConfirmScreenNamesWhatConfirmingStarts(t *testing.T) {- for mode, wantSends := range map[string]string{- "standard": "including prompts and tool activity",- "metadata_only": "stay here",+ for mode, wantMode := range map[string]string{+ "standard": "Standard",+ "metadata_only": "Metadata only",} {model := newWizardModel(WizardOptions{SignedIn: true,@@ -283,23 +301,28 @@ func TestConfirmScreenNamesWhatConfirmingStarts(t *testing.T) {PresetDestination: DestinationAsymptote,PresetPrivacyMode: mode,})- model.width, model.height = 100, 30+ model.width, model.height = 100, 40model.screen = confirmScreenmodel.result.Destination = DestinationAsymptotemodel.result.PrivacyMode = modeview := strings.Join(strings.Fields(model.View()), " ")for _, want := range []string{- "This installs Beacon and starts forwarding to beacon.sh.",- wantSends,+ "Beacon Cloud is operated by Asymptote Labs, Inc.",+ "Destination: Beacon Cloud",+ "Capture mode: " + wantMode,+ "Turn off research and AI training any time in Beacon Cloud: click your profile picture (top right), then Settings.",+ "Change capture mode any time with `beacon endpoint connect --privacy-mode`.",+ "Stop sending any time with `beacon endpoint disconnect`.",+ "To delete your data, email [email protected].","enter install and connect",} {if !strings.Contains(view, want) {t.Fatalf("confirm screen for %s missing %q:\n%s", mode, want, view)}}- if strings.Contains(view, "Next step after install") {- t.Fatalf("confirm screen still defers connect to a later command:\n%s", view)+ if strings.Contains(view, "Next step after install") || strings.Contains(view, "(recommended)") {+ t.Fatalf("confirm screen still uses retired copy:\n%s", view)}}diff --git a/docs/cli/endpoint-install.mdx b/docs/cli/endpoint-install.mdxindex f1833693..0e9b68df 100644--- a/docs/cli/endpoint-install.mdx+++ b/docs/cli/endpoint-install.mdx@@ -98,7 +98,7 @@ signs in through beacon.sh, then asks where this machine's telemetry should go:| Answer | What happens ||--------|--------------|-| Beacon Cloud (default) | Shows what will be sent, asks for Standard or Metadata-only privacy, then installs Beacon and connects this endpoint. The confirm screen states that forwarding starts, and that the last 30 days of agent sessions are uploaded, before you accept. An endpoint that is already enrolled keeps its device key and is not re-enrolled. |+| Beacon Cloud (default) | Shows what will be sent, asks for Standard or Metadata-only capture, then installs Beacon and connects this endpoint. The confirm screen names the operator, the destination, and the capture mode, and says how to turn off research and AI training, change the mode, stop sending, or delete the data. It also says that the last 30 days of agent sessions are uploaded, before you accept. An endpoint that is already enrolled keeps its device key and is not re-enrolled. || Local only | Explicitly opts out of managed forwarding. Nothing is sent anywhere; the session backfill stays in the local log. |`--connect` presets Beacon Cloud and skips the destination question. Whetherdiff --git a/docs/cli/endpoint-onboarding.mdx b/docs/cli/endpoint-onboarding.mdxindex d5d1eb80..3a9e4831 100644--- a/docs/cli/endpoint-onboarding.mdx+++ b/docs/cli/endpoint-onboarding.mdx@@ -20,11 +20,14 @@ 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 Cloud**. Beacon Cloud offers free, unlimited- cloud-based retention of every agent session. It adds AI-powered search and- analytics on Beacon's hosted dashboard, with rich findings analyzing your AI- usage coming soon. Local is a dashboard for this machine's telemetry,- kept for as long as the logs are on disk, with nothing leaving the machine.+2. Choose **Local only** or **Beacon Cloud**. Beacon Cloud sends your agent+ sessions to your Beacon account and keeps them in the cloud while your+ account is active. It includes AI-powered search and analytics on Beacon's+ hosted dashboard. Unless you opt out, Asymptote uses your sessions for+ research and AI training and may share de-identified data+ ([beacon.sh/privacy](https://beacon.sh/privacy)). Local is a dashboard for+ this machine's agent activity, kept for as long as the logs are on disk.+ Your agent activity stays on this machine.3. For Beacon Cloud, choose **Standard** or **Metadata only** forwarding.4. Choose the agent tools to set up: Beacon Cloud MCP (Beacon Cloud only) and theBeacon agent skills. Each is selected; press <kbd>space</kbd> to turn one off.@@ -70,15 +73,26 @@ which agent runtimes, skills, and MCP servers are installed does upload once asendpoint's baseline. That detail is documented here rather than shown on the screenwhere someone is choosing.-Standard forwards the complete locally sanitized event. Metadata only strips retained-prompts, responses, reasoning, tool arguments/results, command output, raw fields,-diffs, and optional inventory content locally before upload. See+Standard sends prompts, responses, tool activity, command output, file diffs, and+file contents returned by tools. Common secret formats, such as API keys and tokens,+are masked on your machine before anything is sent. Masking is pattern-based and may+not catch everything, and the upload may include source code, file contents, and+confidential information. Metadata only removes prompts, responses, reasoning, tool+arguments and results, command output, file diffs, and file contents on your machine+before anything is sent. Only structural information is sent: which agent and tool+ran, file paths, exit codes, token counts, timestamps, repository and branch names,+and full command lines. Common secret formats in command lines are also masked.+Change the mode later with `beacon endpoint connect --privacy-mode`. See[`beacon endpoint connect`](/cli/endpoint-connect#privacy-modes) for the exact contract.Confirming Beacon Cloud connects this endpoint in the same command, after the-local install succeeds. The confirm screen says so before you press enter, and names-what the selected privacy mode sends, so it is the point at which forwarding is-authorized. An endpoint that is already enrolled is not re-enrolled: enrollment+local install succeeds. The confirm screen names Asymptote Labs, Inc. as the+operator, the destination, and the capture mode (Standard or Metadata only). It+says how to turn off research and AI training in Beacon Cloud (profile picture,+then Settings), how to change the capture mode (`beacon endpoint connect+--privacy-mode`), how to stop sending (`beacon endpoint disconnect`), and that+deleting data is an email to [email protected]. That screen is where+forwarding is authorized. An endpoint that is already enrolled is not re-enrolled: enrollmentrotates the device key, so a connected machine keeps the key it has and simplyrecords the destination.