- Preface
- About This Book
- Prologue
- Chapter 1. What Kind of Tool Is Jujutsu?
- 1-1. Is Git a Poor Fit for Agentic Development?
- 1-2. The Jujutsu Features That Stand Out in the AI Era
- Column: How Git Revolutionized Version Control
- Chapter 2. Let’s Try Jujutsu
- 2-1. Setting Up Jujutsu
- 2-1-1. Installing Jujutsu
- 2-1-2. Initial Configuration
- 2-2. A Hands-On Tour of Jujutsu
- 2-2-1. Initializing a Repository
- 2-2-2. Checking the Repository’s State
- 2-2-3. Working with Changes
- 2-2-4. Interacting with a Remote
- 2-3. The Three Types of Logs in Jujutsu
- 2-3-1. The Revision Log (
jj log) - 2-3-2. The Evolution Log (
jj evolog) - 2-3-3. The Operation Log (
jj op log)
- 2-3-1. The Revision Log (
- 2-4. The Jujutsu Mental Model
- 2-4-1. What Is a Change?
- 2-4-2. The Difference Between Branches and Bookmarks
- 2-4-3. Working on Anonymous Branches
- 2-5. Commonly Used
jjCommands - Column: Jujutsu’s Roots—What Kind of VCS Is Mercurial?
- 2-1. Setting Up Jujutsu
- Chapter 3. Jujutsu × AI Workflow in Practice
- 3-1. Coordinating AI Agents with Jujutsu
- 3-1-1. Getting AI Agents to Use Jujutsu
- 3-1-2. Permissions Settings for
jjCommands - 3-1-3. Running
jj fixvia Hooks
- 3-2. A Walkthrough of the Jujutsu × AI Development Process
- 3-2-1. Adjusting the Granularity of AI-Created Changes
- 3-2-2. Pushing and Creating a PR
- 3-2-3. Parallel Development with Workspaces
- Column: The Tools That Shaped Jujutsu, Part 1
- 3-1. Coordinating AI Agents with Jujutsu
- Chapter 4. Advanced Jujutsu Techniques
- 4-1. Clever Ways to Specify Your Targets
- 4-1-1. Specifying Revisions Smartly with Revsets
- 4-1-2. Specifying Files Smartly with Filesets
- 4-2. Handy Power-User Commands Worth Knowing
- 4-2-1.
jj absorb - 4-2-2.
jj arrange - 4-2-3.
jj bookmark advance
- 4-2-1.
- 4-3. Alternative Tactics for Git Hooks
- 4-4. Resolving Conflicts Semi-Automatically
- 4-4-1. Mergiraf
- 4-4-2. Weave
- 4-5. UI Tools for Jujutsu
- 4-5-1. jjui
- 4-5-2. JJ View
- Column: The Tools That Shaped Jujutsu, Part 2
- 4-1. Clever Ways to Specify Your Targets
- Chapter 5. The Jujutsu Problem-Solving Guide
- 5-1. FAQ
- 5-1-1. Comparing with Git
- What Can Git Do That Jujutsu Can’t?
- Is There No merge Command?
- Is There No pull Command?
- I Want to Do the Equivalent of Git’s cherry-pick
- 5-1-2. Niche Operations and Settings
- Can I Check a File’s Contents at a Given Point Without Moving
@? - I Want to Split a Change Chronologically
- I Don’t Want Temporary Logs or Dumps in My History
- I Want to Store a Repository’s Jujutsu Config in the Repository Itself
- I Want to Rename a Tracked Bookmark
- Can I Check a File’s Contents at a Given Point Without Moving
- 5-1-3. Jujutsu Trivia
- Is Jujutsu a Wrapper Around Git?
- What Kind of Person Created Jujutsu?
- What Does the Name Jujutsu Actually Mean?
- 5-1-1. Comparing with Git
- 5-2. Troubleshooting
- A Plain Push Silently Becomes a Force Push
- A Cryptic “Error: The working copy is stale” Appears
- A Change Somehow Picked Up a “divergent” Annotation
- Jujutsu Won’t Track My Image or Video Files
- After Merging a PR and Fetching,
@Goes Astray - I Deleted a Remote Bookmark I Was Still Working On from GitHub
- Claude Code Asks for Permission to Run
jj logEven Though It’s Set to allow
- Column: We Want a JJ-Native Hosting Service!
- 5-1. FAQ
- Epilogue
Juju-chu! — Starting Your Jujutsu × AI Workflow with `jj new`
AI coding agents can move faster than Git’s staging-and-commit workflow.
Juju-chu! shows how Jujutsu🐦⬛ gives you automatic commits, reliable undo, and a safer way to reshape messy AI-generated changes—while staying compatible with Git and GitHub. For developers who already use Git and want a calmer AI workflow.
Minimum price
$12.00
$15.00
You pay
Author earns
PDF
EPUB
163
Pages
About
About the Book
A practical Jujutsu guide for Git users who work with AI coding agents
Juju-chu! is a hands-on field guide to Jujutsu (jj), a Git-compatible version control system, written for developers who code with AI agents. By the end of the book, you won't just understand how Jujutsu works—you'll be ready to use it in your everyday development work.
Why Jujutsu? Git was designed for humans who stage and commit carefully, when ready.
AI coding agents broke that rhythm: they generate and rewrite large amounts of code in seconds, while you're still deciding what to `git add`. Forgotten commits, tangled diffs too large to split cleanly, and the constant stop-and-go of staging while your agent races ahead—these aren't carelessness. They're a structural mismatch.
Jujutsu resolves that mismatch. Commits happen automatically, so there's nothing to forget. Every operation can be undone, giving you an absolute safety net. Conflicts don’t stop you—Jujutsu records them as part of history without blocking, so you can resolve them whenever you’re ready. And since Jujutsu speaks Git under the hood, you can adopt it on your own while the rest of your team stays on Git.
Inside the book:
- A hands-on tour to get a feel for Jujutsu right away
- Jujutsu's mental model and how it differs from Git's—changes, bookmarks, the evolution log, and the operation log
- Practical AI-agent workflows: coordinating AI agents with jj, reshaping AI-generated changes, running agents in parallel across workspaces, and pushing to GitHub
- Q&A and troubleshooting for the questions and edge cases you’ll hit in real projects
The book is written as a dialogue between a senior and a junior engineer—playful on the surface, practical underneath. If you already use Git and work (or plan to work) with agents like Claude Code or Codex CLI, this book is for you. This book assumes you already know the basics of Git.
Support page: https://github.com/klemiwary/Juju-chu-en
Feedback
Author
About the Author
Yuka Ooka
Yuka Ooka began her career as a PHP and Ruby developer and product manager at several Japanese IT companies before going freelance in 2016. She took an early interest in React, still a niche technology in Japan at the time, and worked with a series of clients as a React specialist. Drawing on that experience, she wrote the Riakuto! (りあクト！) series. It struck a chord with readers in Japan, selling over 40,000 copies in total.
Contents
Table of Contents
Get the free sample chapters
Click the buttons to get the free sample in PDF or EPUB, or read the sample online here
The Leanpub 60 Day 100% Happiness Guarantee
Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms...
Earn $8 on a $10 Purchase, and $16 on a $20 Purchase
We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.
(Yes, some authors have already earned much more than that on Leanpub.)
In fact, authors have earned over $15 million writing, publishing and selling on Leanpub.
Learn more about writing on Leanpub
Free Updates. DRM Free.
If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).
Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.
Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.
Learn more about Leanpub's ebook formats and where to read them
Write and Publish on Leanpub
You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!
Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.
Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.