v0.3.0

You can now ask a tour about the step you are reading, and diagrams are drawn by the tool instead of the LLM.

What changed

• Ask about a step. Press ? to pick one of the questions the tour expects at that step, or type your own. The LLM answers from the same files the tour was written from, and the answer becomes the next step. For a tour that tour generated, answers are saved with it. For a tour file you open, they last until you quit.
• Diagrams drawn by the tool. The LLM describes a flow, a timeline or the map of changed files, and tour draws it. Shapes and colors stay the same from tour to tour, and changed and new parts stand out. Notes on code are attached to the line they talk about.
• Easier to read on the screen. Long lines of code wrap instead of being cut off. Tables and code too wide for the right column move below at full width. Flows that start separately, such as a timer job next to a request, are kept apart.
• Judgments grounded in the repository. The LLM now gets the senior engineers' lessons as reference files. A finding is marked "must fix" only when the tour can show an input from this repository that breaks it, and code the repository controls is checked before a problem is blamed on an outside service. In blind reviews on changes the prompts were not tuned on, the average score went from 3.94 to 4.38 out of 5.
• New example tours and demo GIFs.

Tours you saved with v0.2.0 are written again the next time you open the same change, because the prompts changed. With Claude Code, one tour now uses the equivalent of about $1.10 to $1.50 at API prices, a little more than before, because the LLM reads the lessons too.

Install or update

curl -fsSL https://raw.githubusercontent.com/init-co-jp/diff-tour/main/install.sh | sh