Sessions: Onboarding or first-time guidance would help developers orient themselves to the new UX #302122
Description
During the recent Agent Sessions UX study some participants suggested it was difficult to get started.
Problem: Three participants explicitly noted that they needed more guidance to get started. The tool provides no walkthrough, tooltip hints, or getting-started flow. Even experienced developers who are familiar with multiple AI coding tools found themselves uncertain about basic operations: how to clone a repo, where files appear, how to start a session, what local vs. cloud means.
Observed behaviour:
P2026-03-11-1100: Explicitly asked for step-by-step guidance. Said: "While I started this application, I'm as... I'm the actual new user, right? You can see the steps, right? The next, next, next steps right there: 1, 2, 3. While onboarding, a simple act could help eventually."
P2026-03-12-1100: Found the tool appealing but noted the learning curve. Said: "I like it. It's got a little bit of a learning curve... It'd just be something that I'd have to sit down and essentially learn and teach myself the new setup and everything. I wish I could fly through it a lot faster."
P2026-03-13-1230: Did not understand the difference between local and cloud modes. Asked: "Can you just tell me what's the difference between a local and a cloud over here?"
Expected behaviour:
A brief first-run experience (3–5 steps) that highlights: (1) where the file tree is, (2) how to start a session, (3) what local vs. cloud means, (4) where customisation (skills, instructions) lives.
Contextual hints on first use for key UI elements.