How does the skill prevent the AI from hanging?

The skill strictly enforces the use of message flags (-m) and prohibits interactive flags (-i), ensuring Claude never attempts to open a text editor or TUI that requires manual user input.

Can this skill handle colocated Git and jj repositories?

Yes, it is designed to recognize '.jj' directories and ensure that the agent uses jj commands exclusively to keep the underlying Git state in sync without causing conflicts.

Why should Claude use jj instead of Git in these repositories?

Jujutsu's architecture treats the working copy as an automatic commit, which simplifies state management for AI agents and makes history rewrites much safer than standard Git operations.

What are Change IDs and why are they used?

Change IDs are stable, short letter strings that identify a logical change. Unlike Git commit hashes, they remain the same even after the change is rebased or amended, making them ideal for agents to track.

Jujutsu VCS Assistant

Name: Jujutsu VCS Assistant
Author: plasticbeachllc

byplasticbeachllc

0•

开发者工具

Guides AI agents through Jujutsu (jj) version control operations to ensure safe, non-interactive, and efficient repository management.

The Jujutsu VCS Assistant is a specialized skill designed to bridge the gap between AI agents and the Jujutsu (jj) version control system. It establishes a critical set of rules to prevent common pitfalls, such as the agent hanging on interactive prompts or accidentally using Git commands in a jj-managed environment. By providing a clear mental model of jj's unique 'working copy is a commit' architecture, the skill enables Claude to perform complex rewrites, manage change-ID based bookmarks, and handle multi-agent workspace isolation with precision and safety.

主要功能

01Provides specific guidance for managing colocated .jj and .git repositories and workspaces.

02Automates the transition from Git workflows to jj equivalents for status, log, and branching.

03Enforces non-interactive command flags to prevent agent hangs during commit or describe operations.

040 GitHub stars

05Implements a stable change-ID targeting system that persists through history rewrites.

06Supports isolated multi-agent bookmark models for clean feature development.

使用场景

01Safely restructuring and rebasing complex commit histories using jj's mutable commit model.

02Managing version control in repositories where Jujutsu is used as a primary or secondary VCS.

03Coordinating parallel feature work across multiple AI agents using isolated bookmarks.

主要功能

01Provides specific guidance for managing colocated .jj and .git repositories and workspaces.

02Automates the transition from Git workflows to jj equivalents for status, log, and branching.

03Enforces non-interactive command flags to prevent agent hangs during commit or describe operations.

040 GitHub stars

05Implements a stable change-ID targeting system that persists through history rewrites.

06Supports isolated multi-agent bookmark models for clean feature development.

使用场景

01Safely restructuring and rebasing complex commit histories using jj's mutable commit model.

02Managing version control in repositories where Jujutsu is used as a primary or secondary VCS.

03Coordinating parallel feature work across multiple AI agents using isolated bookmarks.