You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat: [ENG-2697] surface vc/sync/cross-agent controls in onboarding tour
Msg 1 closes with a teaser line ("Also version-controlled, cloud-syncable,
and shareable across agents — more at the end") so users know more controls
exist without diluting the local-only trust climax. Msg 3 Part 1 delivers
on it with three short bullets covering brv vc, brv vc push/pull, and
connector cross-agent sharing.
Without this, the tour leaves users thinking ByteRover is local-only with
no team or sync story — they discover the full surface area accidentally
or not at all.
Copy file name to clipboardExpand all lines: src/server/templates/skill/onboarding.md
+15-2Lines changed: 15 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -101,6 +101,7 @@ Saved:
101
101
102
102
Lives at .brv/context-tree/ — local-only.
103
103
See it in your browser: http://localhost:7700
104
+
Also version-controlled, cloud-syncable, and shareable across agents — more at the end.
104
105
```
105
106
106
107
**The pain-naming + commitment paragraph** is the wow. It should:
@@ -127,6 +128,7 @@ stop re-explaining. You start where you left off.
127
128
128
129
Lives at .brv/context-tree/ — local-only.
129
130
See it in your browser: http://localhost:7700
131
+
Also version-controlled, cloud-syncable, and shareable across agents — more at the end.
130
132
```
131
133
132
134
**If the user shared no pain** (after the one-nudge attempt), skip the pain-naming paragraph entirely. Don't manufacture one. Show the identity bullets, the location line, the URL, the pause invitation. The tour still works; just without the life-saving moment.
@@ -137,6 +139,8 @@ Do NOT tell the user to "run `brv webui`" — the daemon auto-starts the web ser
137
139
138
140
Do NOT ask "is this right?" — that turns the artifact into a form. Users who want to correct it will; users who don't, won't be slowed down.
139
141
142
+
The closing teaser line ("Also version-controlled, cloud-syncable, and shareable across agents — more at the end") plants a seed for Msg 3 Part 1. Keep it to one line. Do NOT explain `brv vc` or connectors here — the point is to signal "you have more controls when you want them" without diluting the local-only trust climax. The frame is *opt-in additions to the local default*, not contradictions to it.
143
+
140
144
Before the pause invitation, give the user a **2-beat concept map** so they know where they are in the flow and what's coming. Without this, "I'll show you retrieval next" is meaningless — the user has no idea what retrieval is or why it matters.
141
145
142
146
**Render this block with clear visual separation from the artifact above** — insert an extra blank line (or a horizontal rule `---`) before it. The concept map is its own distinct beat, not a continuation of the artifact. If it blurs into the artifact, the user reads it as more "saved" output and skims past.
@@ -209,11 +213,20 @@ Msg 3 is **not** a passive close. After Msg 2, the user has saved their persona
209
213
210
214
**Two parts:**
211
215
212
-
### Part 1 — Where memory lives (one sentence)
216
+
### Part 1 — Where memory lives + the three controls
217
+
218
+
Start with the location line — still command-free, same reason as the trust opener (the user is being told *where* and *who controls it*, not how to run a command):
213
219
214
220
> "Your memory lives in `.brv/context-tree/` — all local, you control sync."
215
221
216
-
That's it. One sentence. Avoid command names in this line for the same reason as the trust opener — the user is being told *where* and *who controls it*, not how to run a command.
222
+
Then deliver on Msg 1's "more at the end" promise with **three short bullets**. The trust-opener constraint applies only to the location line above; command names are appropriate here because we're naming capabilities, not establishing trust.
223
+
224
+
> "Three controls you have when you're ready:
225
+
> • **Version control** — `brv vc status`, `diff`, `commit`, `branch`. Git-style, just for your memory.
226
+
> • **Cloud sync, on your terms** — `brv vc push` / `brv vc pull` when you want it. Never automatic.
227
+
> • **Cross-agent sharing** — connectors let Claude, Codex, Amp, OpenCode, and other agents share the same memory."
228
+
229
+
Three bullets max. Do NOT walk through sub-commands, flags, or auth setup. If the user asks for details, point them at `brv vc --help` or `brv connectors --help` — those aren't tour material. The job here is to name what's available so the user knows the surface area exists; they can explore on their own time.
0 commit comments