jj

Use this skill when the user wants to use a modern Git-compatible VCS, view commit history, create branches, manage changes, or collaborate with Git repos using jj (Jujutsu).

SKILL.md

GitHub

Jujutsu (jj) Plugin

A Git-compatible VCS that is both simple and powerful. Works with existing Git repos natively, offering undo, auto-squash, conflict resolution, and more.

Commands

Self

  • jj self version — Print version

Log

  • jj log show — Show commit log with revision graph

Status

  • jj status show — Show working copy status

Changes

  • jj new create — Create a new empty change
  • jj describe edit — Edit the description of a change
  • jj commit create — Finalize current change with a description

Diff

  • jj diff show — Show diff of a change

Git Integration

  • jj git push — Push changes to a remote Git repository
  • jj git fetch — Fetch from a Git remote

Workspace

  • jj workspace list — List workspaces

Passthrough

  • jj _ _ — Passthrough for any jj command

Usage Examples

  • "Show me the commit log in this repo"
  • "What's my current working copy status?"
  • "Create a new change and describe it"
  • "Show the diff of my current changes"
  • "Push this change to the remote"
  • "Fetch latest changes from the remote"

Installation

cargo install jj-cli

Examples

# Initialize jj in a Git repo
jj git init

# Show log
jj log

# Check status
jj status

# Create new change
jj new -m "my feature"

# Edit description
jj describe -m "Updated: my awesome feature"

# Show diff
jj diff

# Commit
jj commit -m "feat: implement awesome feature"

# Sync with Git remote
jj git fetch
jj git push

# Show changes since main
jj diff --from main

Key Features

  • Git-compatible: works with existing Git repos
  • Undo everything: mistakes are easily reversible
  • Auto-squashing: related changes are automatically squashed
  • Conflict resolution: simpler conflict handling
  • Working-copy-as-a-change: the working copy is a change like any other
  • Multiple workspaces: work on multiple branches simultaneously
  • Built-in log graph and diff tools
  • No staging area: simpler mental model