Is this compatible with colocated Git repositories?

Yes, it includes specific logic for handling colocated repos and workspaces, ensuring environment variables like GIT_DIR are correctly set via direnv or .envrc hooks.

What is the benefit of using change IDs over commit IDs?

Change IDs in Jujutsu are stable across rewrites and rebases, making them significantly more reliable for AI agents to reference than volatile hex commit hashes.

What happens if the -m flag is missing in a commit command?

Without the -m flag, jj attempts to open a text editor for the commit message, which causes the AI agent to hang indefinitely in a non-interactive environment.

How does jj-guide handle multi-agent workflows?

It uses a structural bookmarking model where each agent operates on its own named bookmark branched from main, ensuring isolation and clean feature tracking.

Why can't I use Git commands in a jj repository?

Jujutsu manages the repository state differently than Git; using Git directly can lead to state desynchronization or conflicts that jj is better equipped to handle through its mental model.

Jujutsu (jj) VCS Guide

Name: Jujutsu (jj) VCS Guide
Author: plasticbeachllc

byplasticbeachllc

0•

Developer Tools

Equips AI agents with the specialized knowledge and command patterns required to manage Jujutsu (jj) version control repositories efficiently.

The jj-guide skill provides Claude with a comprehensive framework for interacting with Jujutsu (jj) version control systems, ensuring LLM compatibility and preventing common operational errors. It replaces traditional Git workflows with jj-specific logic, such as automatic tracking, change ID-based referencing, and non-interactive commit patterns. This skill is essential for developers using Claude in projects where Jujutsu is the primary VCS, enabling seamless branching, rebasing, and bookmark management without the risk of hanging the agent in interactive terminal sessions.

Key Features

01Non-interactive commit and describe patterns to prevent agent terminal hangs

02Multi-agent isolation model via structural bookmarking and named branches

030 GitHub stars

04Automated workspace and .envrc configuration for colocated Git/jj repositories

05Advanced change ID and revset navigation logic for stable history management

06Strict Jujutsu command enforcement for .jj repositories to prevent Git conflicts

Use Cases

01Performing complex rebases and history rewrites using stable change IDs

02Managing version control in projects using Jujutsu as the primary VCS

03Maintaining isolated feature branches for multiple AI agents working in parallel

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add plasticbeachllc/jj-skipper jj-guide

For use in Claude.ai and ChatGPT

Key Features

01Non-interactive commit and describe patterns to prevent agent terminal hangs

02Multi-agent isolation model via structural bookmarking and named branches

030 GitHub stars

04Automated workspace and .envrc configuration for colocated Git/jj repositories

05Advanced change ID and revset navigation logic for stable history management

06Strict Jujutsu command enforcement for .jj repositories to prevent Git conflicts

Use Cases

01Performing complex rebases and history rewrites using stable change IDs

02Managing version control in projects using Jujutsu as the primary VCS

03Maintaining isolated feature branches for multiple AI agents working in parallel