jjwf
Jujutsu (jj) workflow skill. This skill should be used when the project uses jj for version control instead of git. Provides guidance on using jj commands and references the jj-vcs skill for detailed documentation.
Install
npx skillscat add schpet/toolbox/jjwf Install via the SkillsCat registry.
SKILL.md
Jujutsu (jj) Workflow
This project uses Jujutsu (jj) for version control instead of git.
Key Differences from Git
- No staging area: All changes in the working directory are automatically part of the current change
- Changes vs commits: jj uses "changes" (identified by change IDs) rather than commits
- Automatic snapshots: The working copy is automatically snapshotted
- Immutable history: By default, only "mutable" commits can be modified
Common Workflow Commands
| Task | Command |
|---|---|
| See current status | jj status |
| View diff | jj diff --git |
| Commit current change | jj ci -m "message" or jj commit -m "message" |
| Set/update description | jj describe -m "message" |
| Squash into parent | jj squash |
| Create new change | jj new |
| Push to remote | jj git push |
| Fetch from remote | jj git fetch |
| Cleanup empty commits | /cleanup |
Agent Guidelines
When working in this repository:
- Use jj, not git: All version control operations should use jj commands
- Always use
-mflag: Forjj describe,jj commit, andjj squashto avoid opening an editor - Use
--ignore-working-copy: For read operations likejj logandjj diffwhen you don't need the latest snapshot - Use
--gitfor diffs:jj diff --gitproduces standard unified diff format
For More Information
For detailed jj documentation, command references, revset syntax, and templates, invoke the /jj command or reference the jj-vcs skill.
Categories
Install
npx skillscat add schpet/toolbox/jjwf Install via the SkillsCat registry.