01 / FOLLOW
Source and explanation, together.
Read syntax-highlighted code with its Markdown context directly above the target line. Move through the codebase without losing the thread.
Code walkthroughs, now in your terminal
Understand code.
One step at a time.
Follow guided codebase walkthroughs with source, context, and navigation in one focused terminal interface.
Open sourceMIT licensedmacOS & Linux
n nextp previousg stepsjk scroll? help
Why Tourminal
Don’t just browse code.
Follow the story.
Codebases make more sense when someone shows you why each piece matters. Tourminal brings that guided path to where developers already work.
02 / CREATE
Give your agent a map.
Tourminal includes authoring guidance for coding agents. Ask for a walkthrough, load the built-in skill, and create a useful tour from real code.
03 / VALIDATE
Keep every step trustworthy.
Catch stale anchors, missing files, invalid patterns, broken links, and unsafe paths before your team starts the tour.
Install
Your next codebase is
one command away.
Install with Homebrew, open any repository with a CodeTour, and start following the path.
Need a binary? Download the latest releaseHomebrewmacOS & Linux
$ brew install jillesme/tap/tourminalThen, from a repository:
$ tourOpen format
Already use CodeTour?
Tourminal follows the open CodeTour format. The same .tour walkthroughs can also be opened with the CodeTour extension for Visual Studio Code .
Take the guided route
through your code.
Follow existing tours. Create new ones with your agent. Keep them reliable in CI.