# Jujutsu

> Use Jujutsu (jj) for version control operations. Provides guidance on jj commands, revsets, commit messages, and workflow. Use when working with version control, making commits, or when git/jj/Jujutsu is mentioned. Use when this capability is needed.

- Skill: `tomevault-io/jujutsu-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/jujutsu-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/jujutsu-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/jujutsu-2

---


# Jujutsu Version Control

## Core Principles

- Use `jj` command for all git work.
- jj primarily operates on revision IDs and revsets.

## Help

- `jj -h` shows all commands
- Every jj command has a `-h` flag
- `jj help -k revsets` shows revset language documentation
- `jj help -k` shows all documentation options

## Commands

### Viewing History

```bash
jj show -r <revision_id> # View a commit
jj log -r <revset>       # Commit history matching revset
jj log -n <number>       # Last n commits
jj log -T 'description'  # Commits + full descriptions
jj log -r ..             # All commits (not just mutable ones)
```

**Note**: By default, `jj log` only shows "mutable" commits (not on trunk branch and pushed). Use `jj log -r ..` to see all commits.

### Creating and Updating Commits

```bash
jj commit -m "<message>" # Save current commit and start new one on top
jj new -r <revision>     # Create new commit based on a revision
jj desc -m "<message>"   # Update description of current commit
```

## Commit messages

- Use short, succinct summary line, then descriptive detail below
- Be thorough, but only include information relevant to the changes
- Do not be self-congratulatory
- Don't mention line numbers (they're in the diff)
- Never hard-wrap lines

## Log Format

Log items appear in this format:

```
vxu 👋 Me 18 hours ago ado-241730-update-proposal-buttons git_head() abd Use the new view/edit guidelines for proposal buttons
│   │     │              │                                           │   │
│   │     │              │                                           │   └─ Commit Message
│   │     │              │                                           └─ Commit ID
│   │     │              └─ Bookmarks and Tags
│   │     └─ Timestamp
│   └─ Author
└─ Revision ID
```

## Revsets

Revsets are expressions that select sets of revisions. Use `jj help -k revsets` for full documentation.

Common patterns:
- `@` - current revision
- `..` - all revisions
- `<revision>..` - revision and all ancestors
- `@..` - current revision and ancestors

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/mybuddymichael) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->