using-jj
SKILL.md
Using Jujutsu (jj)
Overview
Jujutsu (jj) is a Git-compatible VCS that treats commits as mutable objects identified by a Change ID. It emphasizes a "stacked diffs" workflow where you can easily manipulate history.
When to Use
- Always when a
.jjdirectory exists in the project root. - Creating commits, branches (bookmarks), and PRs.
- Rebasing, splitting, or squashing changes.
Core Concepts
- Change ID: Constant identifier (e.g.,
kkmpptxz) for a change. Persists across rewrites. - Commit ID: Git SHA (e.g.,
a1b2c3d). Changes every time you modify the revision. - Bookmark: Equivalent to a Git branch. Points to a specific revision.
- Working Copy (@): The revision you are currently editing.