| name | jj |
| description | Use jj (Jujutsu) for local version control instead of git. Activate when: the repo has a .jj/ directory, the user or project config mentions jj, the user says 'use jj', or any version control operation is needed in a jj-managed repo. |
jj (Jujutsu) — Version Control for Agent Workflows
UTILITY SKILL for local version control. jj coexists with Git: use jj locally; the remote is standard Git.
USE FOR
- Local version control in repos with a
.jj/ directory
- Committing, branching, rebasing, splitting, or undoing changes with jj
- Agent-assisted workflows requiring change-by-change iteration
DO NOT USE FOR
- Repos without
.jj/ — use git instead
- Production CI/CD pipeline configuration
- Advanced jj features beyond common operations (use
jj help)
Execution Skeleton
- Detect:
test -d .jj. If absent, do not activate.
- Use jj commands for all local VCS operations.
- For workflows and remote interaction, see reference modules.
Reference Map
- essentials: Mental model, detection, setup, inspect/work/reorganize commands, parallel workspaces
- workflow-patterns: Five agent workflow patterns (start task, interrupt/resume, split, skeleton planning, undo)
- remote-and-caveats: Git bridge, bookmarks, push, cleanup, common mistakes, advanced help
Quick Reference
| Task | Command |
|---|
| Init in git repo | jj git init --colocate |
| See status | jj log |
| Describe change | jj describe -m "..." |
| Start next task | jj new |
| Edit older change | jj edit <change> |
| Discard change | jj abandon |
| Split change | jj split |
| Undo anything | jj undo |
| Fetch remote | jj git fetch |
| Rebase onto master | jj rebase -d master |
| Create bookmark | jj bookmark create <name> -r @ |
| Push | jj push / jj push --bookmark <name> |
