Repository navigation
Closed
Labels
area: clipackages/stim-cli, including its README and guidepackages/stim-cli, including its README and guidearea: desktopapps/desktopapps/desktoppriority: P2Normal; default when unsureNormal; default when unsuretype: featureAdds or changes behavior, including performance and polishAdds or changes behavior, including performance and polish
Description
Problem
The Stim Desktop tutorial steps ask the user to read more than to act:
- Every step has a "Commands to run yourself" / "Commands your agent will run" disclosure the user does not need.
- Every step has both Skip and Mark Done, two buttons for the same "move on".
- Second (parallel) change relies on guide text telling the agent to use a new worktree instead of a prompt the user can copy.
- The agent does not verify the user's changes on the device, so the Agent Actions and Replay step often has nothing to show.
- Agent Actions and Replay has no highlight or ticks, and carries a readiness log-lines sentence.
- Live View and Control: the "Live view opened" and "Device controlled" ticks do not update, and the tutorial is hidden while live view is open.
- Share Your Finish cannot detect the PR the agent opened.
- Make a Change does not point at the launch toast's Show button.
- The highlight is a solid stroke; draft polish(desktop): tutorial highlights only on controls, as a fading glow #3164 (fading glow) has conflicts.
Evidence
Maintainer walkthrough of the tutorial against appandflow/stim-tutorial (#4 added tap-button, dark-accent-switch, name-input, accent-card).
Cause
Unknown for the live-view ticks until investigated (viewer .opened(udid) / .input(udid) events vs the tutorial's tracked device). The rest is design.
Fix idea
One PR, one commit per item (all approved):
- (a) Remove the commands disclosure and its plumbing (step command lists) if nothing else uses them. Keep
stim guide tutorial. - (b) Replace Skip / Mark Done with one Next that records done (ticks complete or auto-detected) or skipped. Auto-completing steps still advance. Restart keeps its confirmation.
- (c) Second change: "Tell your agent" prompt with Copy asking for a new worktree; drop the second-worktree guidance from the guide's overview and pause, keeping what finish and delete need. Share stays one PR from the first change.
- (d) Guide run section: the agent verifies each change with agent-device (tap
tap-button, toggledark-accent-switch, type inname-input, screenshot, re-snapshot between actions). - (e) Agent Actions and Replay: one line, glow Agent Actions for the first change's device then Replay, ticks "Agent actions viewed" and "Replay played", one line when no actions were recorded.
- (f) Live View and Control: fix the ticks (with a StimKit test), glow the Control button then the screen, auto-advance when both ticks are done, keep the tutorial visible while live view is open, one-line copy.
- (g) Share Your Finish: detect an open PR for the first change's worktree from the PR info Desktop reads, tick, link and complete; short copy and prompt.
- (h) Make a Change: glow the launch toast's Show button, "Open the build" fallback link. Fold the fading glow from polish(desktop): tutorial highlights only on controls, as a fading glow #3164.
Metadata
Metadata
Assignees
Labels
area: clipackages/stim-cli, including its README and guidepackages/stim-cli, including its README and guidearea: desktopapps/desktopapps/desktoppriority: P2Normal; default when unsureNormal; default when unsuretype: featureAdds or changes behavior, including performance and polishAdds or changes behavior, including performance and polish
Activity
janicduplessis commentedon Oct 10, 2026
Claimed: feat/3366-tutorial-guided-steps
feat(desktop): drop the tutorial's commands disclosure
feat(desktop): one Next button per tutorial step
feat(tutorial): give the parallel change a copyable prompt that asks …
feat(tutorial): the agent checks each change on the device with agent…
feat(desktop): tutorial glow points at the launch notice's Show button
feat(desktop): Agent Actions and Replay step glows the actions list, …
fix(desktop): Live View and Control ticks either tutorial simulator, …
feat(desktop): Share Your Finish detects the pull request from the fi…
Merge origin/main into feat/3366-tutorial-guided-steps
Merge origin/main into feat/3366-tutorial-guided-steps
fix(desktop): tint the tutorial's Open the build link
fix(desktop): let taps pass through the viewer's tutorial card; align…
feat(desktop): tutorial guided steps: one Next, prompts, glows, live-…