// the find
steveklabnik/jujutsu-tutorial
trying to figure out this jujutsu thing
An mdBook-based tutorial for Jujutsu (jj), the experimental version control system that runs on top of git. Written by Steve Klabnik — who has also written the Rust book — so the prose is clear and the pacing is deliberate. Aimed at git users who want to understand jj's mental model, not just its commands.
The author knows how to write for developers who already have strong git intuitions, so he can explain jj's divergent model (no index, anonymous branches, conflict as a first-class state) without dumbing it down. The real-world-workflows section covers actual GitHub PR flows rather than stopping at toy examples. Structure is logical: hello-world → branching → sharing code → advanced, which mirrors how someone would actually adopt jj incrementally. Hosted on GitHub Pages so you can read it without cloning anything.
Last updated February 2026 and jj is still moving fast — some commands and flags have already changed since the tutorial was written, and there's no indication of which jj version the content targets. The 'advanced' section is thin: two pages covering simultaneous edits and not much else, so you'll hit a wall once you're past the basics. No coverage of jj's operation log (`jj op log`) or undo semantics, which are arguably jj's best safety feature and a major reason to switch. At 453 stars, it's not widely known despite being one of the better written introductions out there.