Onboarding Guardian (a hint when setup stalls)
An invisible assistant that watches a new user move through setup and the interactive tour, staying silent almost all of the time and speaking up only when someone is genuinely stuck on a step. It exists so a first run that stalls produces one gentle hint instead of a dead end.
On this page
What it is
What it is — The Onboarding Guardian is an invisible AI
The Onboarding Guardian is an invisible AI assistant that quietly watches a new user move through the Setup v2 cinematic onboarding flow and the interactive tour. It stays silent almost all of the time and surfaces a single gentle hint ONLY when you appear genuinely stuck — for example, when you idle on a step with no forward progress. It can also act on your behalf during onboarding — highlight the control you need, open the right panel, or launch your first task — but it never does anything destructive and never runs outside onboarding.
It is on by default and you can turn it off any time from Settings (the onboardingGuardianEnabled toggle). Because it only runs while the Setup v2 flow or the tour is active, it stays completely dormant — and spends nothing — until that newer onboarding is your live first-run experience.
A hint appears as an ordinary dismissible toast (the same surface as coaching tips), with an optional action button and a "Don't show again" option — never a blocking popup.
Where to find it
Nowhere to open — it is active during Setup v2 and the interactive tour, and its one hint arrives as an ordinary in-app toast. It is on by default and only ever speaks while onboarding is running.
How it behaves
How to use it
- There's nothing to launch. When onboarding (Setup v2 / the tour) is active and the Guardian is enabled, it observes your progress in the background.
- A hint only when you're stuck. If you idle on a step past a short threshold with no progress, the Guardian may show ONE gentle hint — a short message and, sometimes, a button that does the next step for you (highlight a control, open the right panel).
- Dismiss or silence it. Every hint is dismissible; "Don't show again" silences the Guardian for the rest of that onboarding session.
- Turn it off entirely. Turn off the Onboarding Guardian in Settings (
onboardingGuardianEnabled). The opt-out is honored immediately — a disabled Guardian never observes, decides, or acts.
Related
Related — first-time-setup.md
- first-time-setup.md — the Setup v2 onboarding flow the Guardian watches
- app-tour.md — the interactive tour the Guardian also observes
- notifications-and-silence.md — the toast surface the Guardian's hints reuse
Last verified 2026-09-23