Skip to content

Desktop tutorial: guided steps (one Next, prompts, glows, live-view ticks, PR detection) #3366

Closed

Description

@janicduplessis

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, toggle dark-accent-switch, type in name-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.

Activity

  1. added
    type: featureAdds or changes behavior, including performance and polish
    priority: P2Normal; default when unsure
    area: clipackages/stim-cli, including its README and guide
    on Oct 10, 2026
  2. janicduplessis commented on Oct 10, 2026

    @janicduplessis
    CollaboratorAuthor

    Claimed: feat/3366-tutorial-guided-steps

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: clipackages/stim-cli, including its README and guidearea: desktopapps/desktoppriority: P2Normal; default when unsuretype: featureAdds or changes behavior, including performance and polish

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions