using-jj

Manage tasks and track changes in Jujutsu (jj) repositories via TypeScript API.

1|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/zgagnon/skills --skill using-jj-zgagnon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-jj
Source: https://github.com/zgagnon/skills/tree/main/using-jj
Command: npx skills add https://github.com/zgagnon/skills --skill using-jj-zgagnon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you manage complex task workflows and change tracking using Jujutsu (jj) version control, ensuring your progress is always checkpointed and your commit history remains clean.

Core Features & Use Cases

  • Checkpointing: Save incremental progress on a task as bullet points in the commit description.
  • Working Copy Model: Understand and leverage jj's unique model where work happens in an empty working copy.
  • Workflow Management: Implement a robust cycle of starting, checkpointing, and finishing changes.
  • Use Case: When developing a new feature, you can checkpoint your progress every hour, ensuring that even if interrupted, your work is saved and clearly documented within the commit history.

Quick Start

Use the using-jj skill to start a new change with the description 'Implement user authentication'.

Frequently Asked Questions about using-jj

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I checkpoint progress in Jujutsu version control?

Checkpointing in Jujutsu involves saving incremental task progress as bullet points in the commit description. This ensures work is documented and preserved within the commit history even if interrupted.

What is the working copy model in jj version control?

The jj working copy model is unique because work happens in an empty working copy. This approach separates the working state from the commit history, allowing for safer and more flexible change management.

How do I manage task workflows and change tracking with jj?

You can manage task workflows by implementing a robust cycle of starting, checkpointing, and finishing changes. This maintains a clean commit history while tracking detailed task progress.

Does this jujutsu workflow support examine-commit-work-squash cycles?

Yes, the workflow supports examine-commit-work-squash cycles. This allows you to review changes, commit work incrementally, and squash commits later to maintain a clean and logical project history.

Do I need TypeScript to use jujutsu checkpointing features?

The jujutsu checkpointing and task management features are facilitated through a TypeScript API. You need an environment that supports TypeScript to leverage these specific automated workflow scripts.