Update for Jujutsu version 0.37

• In jj v0.36, the --destination flag of the jj rebase command was renamed to --onto.

• In jj v0.37, the syntax of the jj bookmark track command was changed. Previously, name and remote were specified as name@remote. Now you can simply run jj bookmark track <name>, without @origin. The remote can optionally be specified with the --remote flag, but you don't need to worry about that if you're only using one remote. The tutorial doesn't discuss workflows with multiple remotes yet, so I don't mention the new --remote flag in the tutorial.

You can subscribe to these releases to stay up to date with new tutorial content and updates from Jujutsu that are relevant to readers.

New chapter: Split a messy working copy

I wrote a new chapter as part of level 3: Split a messy working copy. It teaches you what to do when you made unrelated changes that belong in separate commits, but forgot to actually run jj commit in between. I hope you like it!

Update for Jujutsu version 0.35

"Jujutsu for everyone" is a tutorial for the Jujutsu version control system that doesn't require experience with Git or any other VCS. Check it out here: https://jj-for-everyone.github.io/

• In jj v0.34, "colocated" repos became the default. Before that release, the book told readers to configure colocated repos as the default manually with jj config set --user git.colocate true. This is not necessary anymore and can be removed with jj config unset --user git.colocate. (I updated this a month ago, but felt like the change is too small to publish a release about it.)

• In jj v0.35, it became possible to track bookmarks that are absent on the remote. That means the command jj bookmark track <bookmark-name>@<remote-name> can be used in both situations: When it exists only on the remote and you want to update it locally, as well as when a bookmark is created locally and intended to be pushed to the remote. I updated the book to use that consistently. In particular, it is not necessary anymore to use the --allow-new flag when pushing new bookmarks with jj git push. You can track the bookmark first instead. The --allow-new flag will likely be deprecated in the future.

You can subscribe to these releases to stay up to date with new tutorial content and updates from Jujutsu that are relevant readers.

Support for Jujutsu version 0.33

"Jujutsu for everyone" is a tutorial for the Jujutsu version control system that doesn't require experience with Git or any other version control system. Check it out here: https://jj-for-everyone.github.io/

Jujutsu version 0.33 has just been released 🥳

"Jujutsu for everyone" has been updated to take full advantage of the new changes. Here's what's probably relevant to you:

• jj undo can now sequentially undo operations you made on the repository one-by-one. This was a blocker for level 3, which I already wrote with this behavior in mind. You can go ahead and read level 3 now!

• There is a new configuration option to make repositories "colocated" by default. The tutorial now instructs readers to enable this option. It will become the default anyway in next month's release of version 0.34. Run the following command to enable it:

  jj config set --user git.colocate true

Other improvements I made since the last release:

• The reset script now checks that your Jujutsu version is recent enough to follow along with the tutorial. So, if you come back after a while and reset to the state of the chapter you want to continue with, the script will tell you if you need to update Jujutsu.

• I got some feedback that terminal output didn't render nicely for the light themes of the book. This is now fixed. Also, the default theme now adjusts to your system setting (light / dark). Personally, I will continue to write the tutorial using dark mode, so please continue to let me know if something looks off for the light themes.

Level 3

"Jujutsu for everyone" is a tutorial for the Jujutsu version control system that doesn't require experience with Git or any other version control system. Check it out here: https://jj-for-everyone.github.io