How I use jj

I like jj.

This book is me sharing how I use it with friends, teammates, and anyone curious about the workflow.

It is not a complete tutorial. It is not a command reference. It is just the stuff I actually do and why I enjoy it.

The short version: jj makes it cheap to change my mind.

I can start messy, commit early, split work later, move fixes into the right commit, push small PRs, and undo local experiments when they were not useful. That fits the way I like to work.

I assume you know Git enough to understand commits, branches, rebases, and pull requests. You do not need to know Jujutsu yet.

Some friends I wrote this for are used to Facebook- or Google-style tooling where commits or changes are the main unit of work. If that is you, a lot of this may feel familiar.

If you are completely new, keep the official docs and the linked references nearby. This book is about how I use jj, not a replacement for the manual.

The examples use main as trunk.

I start with the ideas and plain commands. My config and aliases come after the workflow makes sense.