Concept reference

Onboarding & Tutorial Mode

How the first-run walkthrough uses a live agent in review-first mode, and what typed signals advance each step.

1 min read

A live agent, not a slide deck

The onboarding walkthrough is the real agent running in review-first mode. It can inspect the workspace, explain the typed objects you are about to use, and route you to the right surface — but it will not materialize files or launch compute. Every step is rehearsable.

Typed gates advance the tour

Steps advance only when a typed signal lands: a slash command, a help-drawer tool load, a UIMessage part, or a widget response. Free-form text is never classified into tutorial state, so the tour never advances by accident or stalls on prose.

Read-only by design

The tutorial never invokes destructive or expensive tools. The first real compute hop happens only after you leave review-first mode and approve a typed envelope. This is the same approval contract you will use for every production run, so the tutorial doubles as habit training.

Skip, resume, replay

You can skip the tutorial from the welcome card or resume it later from the help drawer. The completion state lives on your user record, not in the URL.

Was this page helpful?

Edit this page on GitHub

Search docs

Find pages across the SimPilot docs.