Jujutsu入門
Jujutsu Primer (ethanlowman.com)
要約
Jujutsu (jj) はGitに慣れた開発者向けの新しいバージョン管理システム(VCS)です。Gitの複雑さを軽減し、自動リベースやネイティブなUndo機能といった強力なワークフローを提供します。Gitリポジトリと併用可能で、段階的な変更の管理やコミットグラフの操作が容易になります。
全文翻訳
Jujutsu入門
このガイドは、Gitに慣れている人がJujutsu (jj) バージョン管理システム(VCS)を簡潔に紹介するものです。
Jujutsuを試す理由
jjは、学習しやすいシンプルなバージョン管理のプリミティブを提供し、それらが強力なワークフローにエレガントに組み合わさります。自動リベースやネイティブなUndo機能は、Gitの鋭いエッジを和らげます。最終的には、他の多くのVCSツールでは試みるには煩雑すぎる新しい強力なワークフローを自然に発見するでしょう。
Gitリポジトリで作業しているなら、今日から試すことができます。JujutsuとGitは同じリポジトリで並行して使用できるため、Gitから完全に離れることなく、gitリポジトリでjjを試すことができます。
個人的には、jjはVCSのブックキーピングを作業記憶から切り離すことができるため、私の生産性を大幅に向上させると考えています。自動リベースは、スタックされた差分(diff)のワークフローを非常に簡単にし、作業記憶の負荷を軽減します。また、使用していて楽しいツールでもあります。
jjのインストール
公式のインストール手順はこちらにありますが、一般的な方法をいくつか紹介します。
# macOS
brew install jj
# Arch Linux
pacman -S jujutsu
# NixOS (ideally from nixpkgs-unstable)
nix-shell -p jujutsu
# ソースから
# (最近のRustとPATH上の~/.cargo/binが必要です)
cargo install --locked --bin jj jj-cli
セットアップと設定
既存のgitリポジトリで、以下を実行します。
jj git init
ここから、jjとgitのリポジトリ状態は自動的に同期されます。
ユーザーの詳細をグローバルに設定するには、以下のようなコマンドを実行します。
jj config set --user user.name "Some One"
jj config set --user user.email "someone@example.com"
エディタでユーザーのjj TOML設定を編集するには、以下を実行します。
jj config edit --user
--userスコープに加えて、jj configには--repoと--workspaceスコープもあります。マージされた設定を表示するには、以下を実行します。
jj config list
コミットと変更
コミット、またはリビジョンは、基本的にgitのコミットと同じものです。これは、1つ以上の親リポジトリスナップショットから派生したリポジトリ状態のスナップショットを表します。これはしばしば、単一の親コミットとの差分、またはマージコミットの場合は、マージ後の複数の親コミットとの差分として視覚化されます。
Gitリポジトリバックエンドを使用する場合、jjのコミットIDはgitのコミットIDと同じです。つまり、16進数文字列形式のハッシュです。以下のjj logの出力では、右側の16進数ハッシュ2bea5e3dと849165bcがコミットIDです。
$ jj log
@ kpqxywon ethan@example.com 2026-11-15 12:17:12 849165bc
│ (empty) (no description set)
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
左側のID(royxmykxとkpqxywon)は変更IDであり、時間とともに物理的に進化する論理的な変更の安定した識別子です。これについては次のセクションで詳しく説明します。
コミットIDと変更IDは、曖昧さのない(一意な)プレフィックスで短縮形として参照できます。jjは、ほとんどのIDの最短一意プレフィックスを親切にハイライトするため、手動で入力しやすくなっています。例えば、kpqxywonをコピー&ペーストする代わりに、最短一意プレフィックスkまでタイプすることができます。
jj showを使用して、コミット2bea5e3dをその短いプレフィックス2で検査できます。
$ jj show 2
Commit ID: 2bea5e3d1992a60ba9ee52c6ce37c55adba9e8fb
Change ID: royxmykxtrkrqppotnrvutxlvrvqyxmy
Bookmarks: main main@git main@origin
Author : Ethan Lowman <ethan@example.com> (2026-11-15 12:10:46)
Committer: Ethan Lowman <ethan@example.com> (2026-11-15 12:10:46)
Adjust config
diff --git a/config.py b/config.py
index 7366a4e31d..174ffea06b 100644
--- a/config.py
+++ b/config.py
@@ -1,1 +1,1 @@
-DEFAULT_LIMIT = 10
+DEFAULT_LIMIT = 20
多くの人が、Deltaのようなカスタム差分フォーマッタを設定しています。興味があれば、設定ドキュメントを参照してください。
変更の作成と進化
コミットグラフをもう一度見てみましょう。
$ jj log
@ kpqxywon ethan@example.com 2026-11-15 12:17:12 849165bc
│ (empty) (no description set)
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
コミット849165bcのノードには@記号が見えます。これは私たちのワーキングコピー、つまりローカルディレクトリで実際にチェックアウトしているコードのスナップショットを表します。この特別なコミットポインタは、さまざまな方法で検査できます。
jj showはコミットの詳細と差分を表示しますが、ここでは空です。
$ jj show
Commit ID: 849165bca19639dbd6ccb53e8c1340e78c36d59a
Change ID: kpqxywonksrltlrkyqukqqsxpltznztk
Author : Ethan Lowman <ethan@example.com> (2026-11-15 12:17:12)
Committer: Ethan Lowman <ethan@example.com> (2026-11-15 12:17:12)
(no description set)
jj statusは差分統計付きのリポジトリ状態を表示します。
$ jj status
The working copy has no changes.
Working copy (@) : kpqxywon 849165bc (empty) (no description set)
Parent commit (@-): royxmykx 2bea5e3d main | Adjust config
jj diffはgit diffとほぼ同じように機能します。現在のワーキングコピーが親コミットと比較して変更がないため、出力は空です。
$ jj diff
@に変更がないため、この出力はあまり面白くありません。例として変更を加えてみましょう。main.pyを編集してjj showを再度実行すると、次のようになります。
$ jj show
Commit ID: 66b59f20c534705cfb753c722222290e9185b22c
Change ID: kpqxywonksrltlrkyqukqqsxpltznztk
Author : Ethan Lowman <ethan@example.com> (2026-11-15 12:26:43)
Committer: Ethan Lowman <ethan@example.com> (2026-11-15 12:26:43)
(no description set)
diff --git a/main.py b/main.py
new file mode 100644
index 0000000000..c74cd2e0e0
--- /dev/null
+++ b/main.py
@@ -0,0 +1,2 @@ def my_new_feature():
+def my_new_feature():
+ pass
$ jj log
@ kpqxywon ethan@example.com 2026-11-15 12:26:43 66b59f20
│ (no description set)
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
いくつかのことが変更されたことに気づくでしょう。ワーキングコピーは自動的にコミットされ、@はもはや(empty)とマークされなくなりました。@の新しいコミットIDは66b59f20です。変更を追加しましたが、66b59f20の変更IDはkpqxywonのままです。jjにはGitのようなステージングエリアがないため、ファイルを手動で追加する必要はありません。ファイルを編集した後、リポジトリの状態を検査または変更するためのjjコマンドを実行すると、jjは自動的にワーキングコピーを関連する論理的な変更のための新しい物理コミットとしてスナップショットします。
この変更に説明(コミットメッセージとも呼ばれます)を付けましょう。エディタを開くjj descを実行するか、-mで直接指定できます。
$ jj desc -m "Implement the feature"
Working copy (@) now at: kpqxywon 6b89ffb2 Implement the feature
Parent commit (@-) : royxmykx 2bea5e3d main | Adjust config
ここでもコミットIDが変更されたことに注意してください。ハッシュはコミットメッセージを含むためですが、変更IDは安定したままです。
次に、この新しい機能を使用する準備ができたと仮定し、その変更を別のコミットに整理したいとします。jj newで新しいコミットを作成できます。
$ jj new
Working copy (@) now at: nlrtlrxv 6cca2add (empty) (no description set)
Parent commit (@-) : kpqxywon 6b89ffb2 Implement the feature
$ jj log
@ nlrtlrxv ethan@example.com 2026-11-15 12:35:49 6cca2add
│ (empty) (no description set)
○ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
kpqxywonの上に空の変更nlrtlrxvを作成しました。jj statusは、まだ親と差がない新しいリビジョンを編集していることを反映しています。
$ jj status
The working copy has no changes.
Working copy (@) : nlrtlrxv 6cca2add (empty) (no description set)
Parent commit (@-): kpqxywon 6b89ffb2 Implement the feature
jj commitは、一般的なjj descとjj newの組み合わせのショートカットです。新しい機能を使用する別の変更を加えて、コミットしてみましょう。
$ jj commit -m "Use the feature"
Working copy (@) now at: qmkrwlvp 91067ad0 (empty) (no description set)
Parent commit (@-) : nlrtlrxv e1b06678 Use the feature
$ jj log
@ qmkrwlvp ethan@example.com 2026-11-15 12:41:30 91067ad0
│ (empty) (no description set)
○ nlrtlrxv ethan@example.com 2026-11-15 12:41:30 e1b06678
│ Use the feature
○ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
作成したコミット(n)を検査するには、デフォルトで@を表示するだけのjj showはもう使用できません。検査したいリビジョンを渡す必要があります。
$ jj show n
Commit ID: e1b066782aa1a565c1e5d38ef27a308aa58e7e4c
Change ID: nlrtlrxvuuskxprvtuznquqzqzzwvnzk
Author : Ethan Lowman <ethan@example.com> (2026-11-15 12:41:30)
Committer: Ethan Lowman <ethan@example.com> (2026-11-15 12:41:30)
Use the feature
diff --git a/main.py b/main.py
index c74cd2e0e0..0714ec450b 100644
--- a/main.py
+++ b/main.py
@@ -1,2 +1,4 @@ def my_new_feature():
def my_new_feature():
pass
+
+do_something(my_new_feature())
ドキュメント化が必要であることを自分自身に思い出させるために、kの上に新しいコミットを作成しましょう。
$ jj new k -m "Document the feature"
Working copy (@) now at: qwyusntz 46a2ffda (empty) Document the feature
Parent commit (@-) : kpqxywon 6b89ffb2 Implement the feature
Added 0 files, modified 1 files, removed 0 files
jj newフラグの代わりに、別のjj descを実行しても問題ありません。現在のコミットグラフは次のとおりです。
$ jj log
@ qwyusntz ethan@example.com 2026-11-15 12:46:35 46a2ffda
│ (empty) Document the feature
│ ○ nlrtlrxv ethan@example.com 2026-11-15 12:41:30 e1b06678
├─┘ Use the feature
○ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
名前付きブランチを作成せずに分岐コミットを作成したことに注意してください。これは、jjのブランチレスモデルと、ワークストリームを整理するためのgitのブランチ中心モデルの大きな違いを浮き彫りにしています。ブランチで作業中の作業を管理する代わりに、コミットのグラフ上で作業します。共有する準備ができたら、コミットグラフからGitフォージにブランチをプッシュします(後述)。
Revsets
Mercurialから借用したアイデアであるrevsetは、コミットグラフからリビジョンのセットを選択する式です。ほとんどのjjコマンドは、引数でrevsetを受け入れます。jj new kを実行したとき、引数kは実際にはIDkpqxywonを持つ単一の変更に解決される単純なrevsetでした。jj logコマンドには、revsetをプレビューするために使用できる-r <REVSET>フラグがあります。いくつかのデモンストレーション例を以下に示します。
@の親:
$ jj log -r @-
○ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
~
rの孫:
$ jj log -r r++
@ qwyusntz ethan@example.com 2026-11-15 12:51:45 5b55579a
│ Document the feature
~
○ nlrtlrxv ethan@example.com 2026-11-15 12:41:30 e1b06678
│ Use the feature
~
rと@の間のコミット(両端を含む):
$ jj log -r r::@
@ qwyusntz ethan@example.com 2026-11-15 12:51:45 5b55579a
│ Document the feature
○ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
コミットkとそのすべての子孫:
$ jj log -r k::
@ qwyusntz ethan@example.com 2026-11-15 12:51:45 5b55579a
│ Document the feature
│ ○ nlrtlrxv ethan@example.com 2026-11-15 12:41:30 e1b06678
├─┘ Use the feature
○ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
~
ethan@example.comによって作成され、IDがkまたはqでもあるコミット:
$ jj log -r 'author("ethan@example.com") & (k | q)'
@ qwyusntz ethan@example.com 2026-11-15 12:51:45 5b55579a
│ Document the feature
○ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
~
網羅的な詳細については、公式ドキュメントを参照します。Revsets言語仕様は、私が最も参照するjjドキュメントページであり、目を通すことをお勧めします。
コミットグラフのナビゲーション
qwyusntzのドキュメント化の過程で、親コミットkpqxywonの実装に間違いがあったことに気づいたとしましょう。タスクを切り替えるために、変更を手動でコミットしたり、ステージングしたりする必要はありません。単にjj editでワーキングコピーをkpqxywonに切り替えます。
$ jj edit k
Working copy (@) now at: kpqxywon 6b89ffb2 Implement the feature
Parent commit (@-) : royxmykx 2bea5e3d main | Adjust config
Added 0 files, modified 0 files, removed 1 files
ワーキングコピーは再びkpqxywonからの変更を表示します。
$ jj show
Commit ID: 6b89ffb2a250f622a8638145d65fe8c9bb308dbf
Change ID: kpqxywonksrltlrkyqukqqsxpltznztk
Author : Ethan Lowman <ethan@example.com> (2026-11-15 12:26:43)
Committer: Ethan Lowman <ethan@example.com> (2026-11-15 12:33:23)
Implement the feature
diff --git a/main.py b/main.py
new file mode 100644
index 0000000000..c74cd2e0e0
--- /dev/null
+++ b/main.py
@@ -0,0 +1,2 @@ def my_new_feature():
+def my_new_feature():
+ pass
jjは、ワーキングコピーの上にある変更、最近のqへの編集を含めて、追跡を失っていません。
$ jj log
○ qwyusntz ethan@example.com 2026-11-15 12:51:45 5b55579a
│ Document the feature
│ ○ nlrtlrxv ethan@example.com 2026-11-15 12:41:30 e1b06678
├─┘ Use the feature
@ kpqxywon ethan@example.com 2026-11-15 12:33:23 6b89ffb2
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
jj edit kでコミットを切り替える代わりに、jj edit @-を実行することもできました。revset@-はワーキングコピーを切り替える前に評価されるため、これは親コミットに移動します。組み込みコマンドjj next [--edit]とjj prev [--edit]は、コミットのスタックを上下に移動する別の方法を提供します。
自動リベース
ワーキングコピーでファイルを編集すると、子孫コミットは次のjj呼び出し時に自動的にリベースされます。例えば、my_new_featureの実装をmain.pyで編集してからjj logを実行すると、コミットk、n、qすべてが新しいコミットIDを取得したことがわかります。jjはリベースを実行したことも通知します。
$ jj log
Rebased 2 descendant commits onto updated working copy.
○ qwyusntz ethan@example.com 2026-11-15 13:03:41 7d293f19
│ Document the feature
│ ○ nlrtlrxv ethan@example.com 2026-11-15 13:03:41 41a43a84
├─┘ Use the feature
@ kpqxywon ethan@example.com 2026-11-15 13:03:41 d9f35831
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
コンフリクトの処理
自動リベースがマージコンフリクトを引き起こした場合、git rebaseのようにすぐに修正する必要はありません。代わりに、jjはコミットがコンフリクトしていることを記録し、現在のタスクを続行できるようにします。これは、スタックされたコミットが複雑になるにつれて、精神的なコンテキストスイッチングを減らすのに非常に役立ちます。
$ jj log
Rebased 2 descendant commits onto updated working copy.
○ qwyusntz ethan@example.com 2026-11-15 13:05:35 b96f8df4
│ Document the feature
│ × nlrtlrxv ethan@example.com 2026-11-15 13:05:35 e562bff4 (conflict)
├─┘ Use the feature
@ kpqxywon ethan@example.com 2026-11-15 13:05:35 c501c0bd
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
コンフリクトを表示するには、コンフリクトしたコミットを編集します。
$ jj edit n
Working copy (@) now at: nlrtlrxv e562bff4 (conflict) Use the feature
Parent commit (@-) : kpqxywon c501c0bd Implement the feature
Added 0 files, modified 1 files, removed 0 files
Warning: There are unresolved conflicts at these paths:
main.py 2-sided conflict
そしてmain.pyを検査します。
def my_new_feature():
print("Hello from the new feature!")
<<<<<<< conflict 1 of 1
%%%%%%% diff from: kpqxywon d9f35831 "Implement the feature" (parents of rebased revision)
\\\ of: kpqxywon c501c0bd "Implement the feature" (rebase destination)
- pass
+ return 42
+++++++ nlrtlrxv 41a43a84 "Use the feature" (rebased revision)
pass
do_something(my_new_feature())
>>>>>>> conflict 1 of 1 ends
テキストエディタでこれらのコンフリクトを解決し、次にjjコマンドを実行すると、jjがコミットを未解決としてマークしたことがわかります。
$ jj status
Working copy changes:
M main.py
Working copy (@) : nlrtlrxv 34f2e2a1 Use the feature
Parent commit (@-): kpqxywon c501c0bd Implement the feature
Undoと操作ログ
例えば、そのコンフリクト解決で間違いを犯し、それを元に戻したいとしましょう。gitでは、アクションを元に戻すことは、可能であっても、しばしば複雑です。jjでは、常にjj undoを実行できます。
$ jj undo
Undid operation: 35beb0741f17 (2026-11-15 13:08:39) snapshot working copy
Restored to operation: f134ca987b59 (2026-11-15 13:07:18) edit commit e562bff4876f3ea76248c3f730e9e74d3e28e8a0
Working copy (@) now at: nlrtlrxv e562bff4 (conflict) Use the feature
Parent commit (@-) : kpqxywon c501c0bd Implement the feature
Added 0 files, modified 1 files, removed 0 files
Warning: There are unresolved conflicts at these paths:
main.py 2-sided conflict
New conflicts appeared in 1 commits:
nlrtlrxv e562bff4 (conflict) Use the feature
Hint: To resolve the conflicts, start by creating a commit on top of
the conflicted commit:
jj new nlrtlrxv
Then use `jj resolve`, or edit the conflict markers in the file directly.
Once the conflicts are resolved, you can inspect the result with `jj diff`.
Then run `jj squash` to move the resolution into the conflicted commit.
より一般的には、jjはすべての操作の履歴をjj op logに保持します。このログを検査し、その履歴のポイントにjj op restoreするか、個々の操作をjj op revertできます。もしjj undo自体が間違いだった場合、jj redoを実行できます。
上記の出力のHintは、次のトピックであるsquashワークフローのネタバレです。
Squashワークフロー
子孫を持つコミットを編集することは、時々不安定に感じられることがあります。作業記憶から離れた大きな差分を反復処理している場合、新しい変更を既存の差分から分離できると便利です。例えば、リベースコンフリクトを解決する差分を単独で検査したい場合があります。
上記の出力の指示に従いましょう。まず、コンフリクトしたコミットの上に新しいコミットを作成します。
$ jj new n
Working copy (@) now at: wqxolloz b878878a (conflict) (empty) (no description set)
Parent commit (@-) : nlrtlrxv e562bff4 (conflict) Use the feature
Warning: There are unresolved conflicts at these paths:
main.py 2-sided conflict
$ jj log -r n::
@ wqxolloz ethan@example.com 2026-11-15 13:11:44 b878878a (conflict)
│ (empty) (no description set)
× nlrtlrxv ethan@example.com 2026-11-15 13:05:35 e562bff4 (conflict)
│ Use the feature
~
ここで、エディタでmain.pyのコンフリクトを解決し、jj logを再度実行します。
$ jj log -r n::
@ wqxolloz ethan@example.com 2026-11-15 13:14:12 91181aec
│ (no description set)
× nlrtlrxv ethan@example.com 2026-11-15 13:05:35 e562bff4 (conflict)
│ Use the feature
~
必要であれば@の差分を検査でき、コンフリクト解決に満足したら、それを親コミットにsquashできます。
$ jj squash
Working copy (@) now at: vkywoywq f6b548b3 (empty) (no description set)
Parent commit (@-) : nlrtlrxv 7208deb7 Use the feature
Existing conflicts were resolved or abandoned from 1 commits.
$ jj log -r n::
@ vkywoywq ethan@example.com 2026-11-15 13:15:39 f6b548b3
│ (empty) (no description set)
○ nlrtlrxv ethan@example.com 2026-11-15 13:15:39 7208deb7
│ Use the feature
~
これでコンフリクトは解決され、作業を続けることができます。
その他のコミットグラフ操作
jjの強力な特長の一つは、差分を粘土のように扱えることです。自動リベースとjj undoによる信頼性により、差分を簡単に移動、結合、削除、分割できます。
現在のコミットグラフでいくつかの操作を試してみましょう。開始点は次のとおりです。
$ jj log
@ vkywoywq ethan@example.com 2026-11-15 13:15:39 f6b548b3
│ (empty) (no description set)
○ nlrtlrxv ethan@example.com 2026-11-15 13:15:39 7208deb7
│ Use the feature
│ ○ qwyusntz ethan@example.com 2026-11-15 13:05:35 b96f8df4
├─┘ Document the feature
○ kpqxywon ethan@example.com 2026-11-15 13:05:35 c501c0bd
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
Rebase
jj rebaseを使用して、分岐したコミットグラフを線形の履歴に強制しましょう。ドキュメントコミット(q)は、実装(k)と使用(n)の間に配置されるべきだとします。これは、nlrtlrxv(とその空の子孫)をqwyusntzの上に移動することで達成できます。
$ jj rebase -s n -o q
Rebased 2 commits to destination.
Working copy (@) now at: vkywoywq 0405560c (empty) (no description set)
Parent commit (@-) : nlrtlrxv 9920235b Use the feature
Added 1 files, modified 0 files, removed 0 files
$ jj log
@ vkywoywq ethan@example.com 2026-11-15 13:20:18 0405560c
│ (empty) (no description set)
○ nlrtlrxv ethan@example.com 2026-11-15 13:20:18 9920235b
│ Use the feature
○ qwyusntz ethan@example.com 2026-11-15 13:05:35 b96f8df4
│ Document the feature
○ kpqxywon ethan@example.com 2026-11-15 13:05:35 c501c0bd
│ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
同じ効果を達成する別の方法は、jj rebase -r q --before nを使用することです。多くのjjコマンドには、revsetを指定する複数の方法があります。jj rebase --helpはこれらをよく文書化しています。
jj rebaseフラグの引数はすべてrevsetであるため、コミットのシーケンスまたはコミットサブグラフを選択し、それをグラフの別の場所に移動するrevsetを記述できます。
コミットをkの下に挿入したい場合、最も直接的な方法はjj new --before kですが、デモンストレーション目的で、rの上に新しいコミットを作成し、k::をその上にリベースすることもできます。
$ jj new r -m "Prepare for the feature"
Working copy (@) now at: wxzmtyol be5ca29b (empty) Prepare for the feature
Parent commit (@-) : royxmykx 2bea5e3d main | Adjust config
Added 0 files, modified 0 files, removed 2 files
$ jj log
@ wxzmtyol ethan@example.com 2026-11-15 13:23:29 be5ca29b
│ (empty) Prepare for the feature
│ ○ nlrtlrxv ethan@example.com 2026-11-15 13:20:18 9920235b
│ │ Use the feature
│ ○ qwyusntz ethan@example.com 2026-11-15 13:05:35 b96f8df4
│ │ Document the feature
│ ○ kpqxywon ethan@example.com 2026-11-15 13:05:35 c501c0bd
├─┘ Implement the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
$ jj rebase -s k -o w
Rebased 3 commits to destination.
$ jj log
○ nlrtlrxv ethan@example.com 2026-11-15 13:28:02 cda0de88
│ Use the feature
○ qwyusntz ethan@example.com 2026-11-15 13:28:02 ec9de16f
│ Document the feature
○ kpqxywon ethan@example.com 2026-11-15 13:28:02 722e7268
│ Implement the feature
@ wxzmtyol ethan@example.com 2026-11-15 13:23:29 be5ca29b
│ (empty) Prepare for the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
TUIsを使用するのが好きなら、jj arrangeはコミットの並べ替えのためのgit rebase -iに似たコミットグラフエディタを提供します。
Squash
ドキュメントが実装と同じコミットに含まれるべきだと判断した場合、squashできます。
$ jj squash --from q --into k
Rebased 1 descendant commits.
jjはエディタを開き、結合されたコミットメッセージを記述する機会を与えてくれます。
$ jj log
○ nlrtlrxv ethan@example.com 2026-11-15 13:31:30 cb468825
│ Use the feature
○ kpqxywon ethan@example.com 2026-11-15 13:31:30 b93e4ef7
│ Implement and document the feature
@ wxzmtyol ethan@example.com 2026-11-15 13:23:29 be5ca29b
│ (empty) Prepare for the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
Abandon
コミットをグラフから削除するには、jj abandonを使用できます。準備コミットを削除してみましょう。
$ jj abandon w
Abandoned 1 commits:
wxzmtyol be5ca29b (empty) Prepare for the feature
Rebased 2 descendant commits onto parents of abandoned commits.
Working copy (@) now at: xzwrrwyv d460fbd4 (empty) (no description set)
Parent commit (@-) : royxmykx 2bea5e3d main | Adjust config
$ jj log
@ xzwrrwyv ethan@example.com 2026-11-15 13:33:49 d460fbd4
│ (empty) (no description set)
│ ○ nlrtlrxv ethan@example.com 2026-11-15 13:33:49 b1284f61
│ │ Use the feature
│ ○ kpqxywon ethan@example.com 2026-11-15 13:33:49 df93f0a6
├─┘ Implement and document the feature
◆ royxmykx ethan@example.com 2026-11-15 12:10:46 main 2bea5e3d
│ Adjust config
~
コミットの一部(ハンクまたはファイル全体への変更)を破棄するには、jj diffedit TUIを使用できます(ドキュメントを参照)。
Split
jj split TUIを使用すると、コミットを選択し、最初のコミットに入れるファイルまたはハンクを選択することによって、2つの連続したコミットに分割できます。jj split -r kを使用して、実装とドキュメントを再度分割してみましょう。
jj-hunkプロジェクトは、コミットを小さな変更のシーケンスに自動的に分割する方法を提供します。もし興味があれば、エージェントはこのツールを使用してコミットを分割し、レビューを容易にすることができます。
ブックマークとGitブランチ
jjにはブランチのネイティブな概念はありませんが、Gitブランチに対応するブックマークというプリミティブがあります。Gitブランチを操作する必要があるときは、ブックマークを介して行います。
Gitをかなり使うとこれに気づくかもしれませんが、Gitブランチは単なるコミットへのポインタです。jjはこのようにブックマークを明示的にモデル化します。jjブックマークは基本的にコミットにアタッチされた名前付きラベルであり、コミットグラフを変更しながら移動させたり、リモートにプッシュ/プルしたりできます。
以下にGitブランチに関するいくつかの基本的なワークフローを説明しますが、jjのGitHubとの連携に関するドキュメントでより完全なガイドを見つけることができます。
新しいブランチのプッシュ
リモートを持つGitリポジトリでjjを初期化したと仮定すると、jj git remote listの出力があるはずです。
$ jj git remote list
origin git@github.com:ethanal/example.git
jjはブランチレスなので、ローカルで作成したコミットにはブランチ名がありません。幸いなことに、jjはブランチ名を選択する必要がなく、自動的に生成してくれます。生成されたブランチ名は、ユニークなブランチ名を考える手間を省き、代わりに良いコミットメッセージ(通常は変更のより永続的な記述子)を書くことに集中できます。
変更IDnlrtlrxvの生成されたブックマークを作成し、対応するGitブランチをプッシュするには、次のようなコマンドを実行します。
$ jj git push -c n
Creating bookmark push-nlrtlrxvuusk for revision nlrtlrxv
Changes to push to origin:
bookmark: push-nlrtlrxvuusk [add to b1284f61]
git: Enumerating objects: 17, done.
git: Counting objects: 100% (17/17), done.
git: Delta compression using up to 32 threads
git: Compressing objects: 100% (14/14), done.
git: Writing objects: 100% (16/16), 25.21 KiB | 6.30 MiB/s, done.
git: Total 16 (delta 1), reused 5 (delta 0), pack-reused 0 (from 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local object.
remote:
remote: Create a pull request for 'push-nlrtlrxvuusk' on GitHub by visiting:
remote: https://github.com/ethanal/example/pull/new/push-nlrtlrxvuusk
remote:
これでjj logは、対応する名前のブックマークpush-nlrtlrxvuuskが関連付けられた変更を表示します。
$ jj log -r n
○ nlrtlrxv ethan@example.com 2026-11-15 13:33:49 push-nlrtlrxvuusk b1284f61
│ Use the feature
~
これでGitHubでこのブランチからPRを作成できます。ブックマークの命名規則は、git_push_bookmarkテンプレート設定でカスタマイズできます。これはこちらに記載されています。ブランチ名を<author name>/<change ID>のような形式にするのは一般的なパターンです。
jj git push -cは変更IDに対応するブランチ名を生成するため、PRごとに1つの変更を推奨しているようです。通常はこれらのエルゴノミクスを活かし、PRごとに1つの変更を持つのが最善だと私は考えています。
ブランチの更新
ブランチを更新するには、ブックマークされている変更にコミットをsquashするか、新しいコミットを作成してブックマークを先に進めるのが一般的なプロセスです。
ブックマークのSquashフロー
既存のブックマークにコミットをsquashすることを選択した場合(PRごとに1つの変更を維持することをお勧めします)、フローは次のようになります。
まず、ブランチの上に新しいコミットを作成します。
$ jj new push-nlrtlrxvuusk
Working copy (@) now at: stzvpxow f14a0cf7 (empty) (no description set)
Parent commit (@-) : nlrtlrxv b1284f61 push-nlrtlrxvuusk | Use the feature
Added 2 files, modified 0 files, removed 0 files
次に編集を行います。
$ jj status
Working copy changes:
M README.md
Working copy (@) : stzvpxow 6bdd43dc (no description set)
Parent commit (@-): nlrtlrxv b1284f61 push-nlrtlrxvuusk | Use the feature
それらをブックマークブランチにsquashします。
$ jj squash --from @ --into push-nlrtlrxvuusk
Working copy (@) now at: xryuuprx 04d65a03 (empty) (no description set)
Parent commit (@-) : nlrtlrxv aeb869ae push-nlrtlrxvuusk* | Use the feature
これで、push-nlrtlrxvuuskの横にアスタリスクが表示され、リモートにプッシュされていない変更があることを示します。それでは、それらをプッシュしましょう。
$ jj git push -b push-nlrtlrxvuusk
Changes to push to origin:
bookmark: push-nlrtlrxvuusk [move sideways from b1284f61c417 to aeb869aef99b]
リモートブランチは新しい変更を反映しています。上記の出力は、ブランチをあるコミットから別のコミットに移動したことを示しており、これは強制プッシュを実行したことを反映しています。jj git pushはgit push --force-with-leaseと同等の動作をします。したがって、プッシュ操作が何をするか不明な場合は、jj git push --dry-runフラグを使用できます。jjは、設定可能な不変コミットのセットを書き換えることを拒否することで、ほとんどの危険な強制プッシュから保護します。デフォルトの不変セットは合理的ですが、独自の不変ヘッドを設定することで、より保守的または攻撃的にすることができます。
ブックマークのAdvanceフロー
このフローでは、ブックマークの上に新しいコミットを追加し、その後ブックマークを新しいコミットを指すように移動します。
まず、新しいコミットを準備します。
$ jj new push-nlrtlrxvuusk
Working copy (@) now at: pptrztmx 6e49ff1f (empty) (no description set)
Parent commit (@-) : nlrtlrxv aeb869ae push-nlrtlrxvuusk | Use the feature
次に編集を行います。
$ jj status
Working copy changes:
M README.md
Working copy (@) : pptrztmx 89027165 (no description set)
Parent commit (@-): nlrtlrxv aeb869ae push-nlrtlrxvuusk | Use the feature
$ jj commit -m "Add a usage example"
Working copy (@) now at: wunttkrp 044f2d98 (empty) (no description set)
Parent commit (@-) : pptrztmx 2341ee4a Add a usage example
ブックマークは自動的に新しいコミットに移動しません。これはブックマークとGitブランチの最大の違いです。今のところ、push-nlrtlrxvuuskは下のコミットを指しています。
$ jj log -r n::
@ wunttkrp ethan@example.com 2026-11-15 13:51:57 044f2d98
│ (empty) (no description set)
○ pptrztmx ethan@example.com 2026-11-15 13:51:57 2341ee4a
│ Add a usage example
○ nlrtlrxv ethan@example.com 2026-11-15 13:43:16 push-nlrtlrxvuusk aeb869ae
│ Use the feature
~
ブックマークを新しいコミットに移動するにはいくつかの方法があります。最も簡単なのはおそらくjj bookmark advanceで、これは最も近いブックマークを指定されたコミットに移動します。
$ jj bookmark advance --to @-
Advanced 1 bookmarks to pptrztmx 2341ee4a push-nlrtlrxvuusk* | Add a usage example
これで、移動したブックマークをプッシュする準備ができました。
$ jj git push -b push-nlrtlrxvuusk
Changes to push to origin:
bookmark: push-nlrtlrxvuusk [move forward from aeb869aef99b to 2341ee4aa554]
リモートブランチのチェックアウト
jjはブランチレスなので、厳密にはブランチを「チェックアウト」しませんが、リモートブランチの上にコミットを作成することはできます。まず、git fetchに相当する操作を行い、リモートブックマークをインポートします。
$ jj git fetch
そして、リモートブランチの上に新しい空のコミットを作成します。
$ jj new some-cool-feature@origin
ワーキングコピーにはリモートブランチ上のすべてのコミットが含まれます。しかし、gitに戻ると、gitの観点からは、ブランチ上ではなくdetached head状態であることがわかります。
$ git status
Not currently on any branch.
nothing to commit, working tree clean
これは、jjがブックマークの上にコミットを編集しており、gitの「現在のブランチ」状態に相当するものがないためです。
トランクからの変更のプル
トランク(例: main)との同期は、このフローの特定の例にすぎません。jj git fetchを実行してアップストリームのmainを更新し、その後コミットをリベースします。例えば、以下は新しいmainの上にmy-branchをリベースします。
jj rebase -b my-branch -o main
グラフ内での方向感覚を保つ
jjのコミットグラフ操作は、画面上にライブのコミットグラフが表示されている場合に最も簡単です。これを達成する方法はいくつかあります。
jjuiは、視覚的なグラフを直接編集できるjj用のTUIです。個人的には使用したことはありませんが、気に入っている人もいます。
私は、viddy(watchのより優れたバージョンで、色をサポートしています)を使用して、画面の隅に常にライブのjj logを表示することを好みます。
viddy -t -n1 jj log --ignore-working-copy --color=always
このログを現在の作業を表すrevsetにフィルタリングすることをお勧めします。開始点として以下を使用します。
visible() & (trunk() | (tracked_remote_bookmarks() & ~::trunk()) | (mutable() & mine())::)
私の実験的なプロジェクトjj-stampを試すことも検討してください。これは、squashワークフロー用のローカルコードレビューGUIです。squashレビューワークフローを使用しない場合でも、ライブのjj logが横に表示され、jj操作を実行するためのターミナルを備えた、かなり優れた差分ビューアになります。
スタックされたPR、簡潔に
jjによる生産性の向上は、スタックされたPRワークフローをサポートできる能力からもたらされます。これは独自の投稿に値するため、ここでは簡潔に説明します。
大きな変更は、論理的なステップのシリーズに分割されると理解しやすくなります。大きな変更をレビューの小さな連続したアトムに分割すると、変更全体が理解しやすくなります。スタックされたPRは、この事実を活用してマージスループットを最適化し、同時にレビュープロセスでのパイプラインの停滞を排除しようとします。
新しい機能を作成しているとしましょう。実装を3つのステージに分割することを決定できます。
- 機能を実装しやすくするためのリファクタリング
- 機能の実装
- 別のシステムでの機能の使用
jjの自動リベースによるスタックされた変更での作業能力は、これらの3つのステージを実装するのに自然に適合します。3つのステージのそれぞれは単一のコミットに対応し、それぞれにブックマーク/ブランチ/PRが関連付けられています。
$ jj log -r oomyzqmz::sxummoow
○ sxummoow ethan@example.com 2026-11-15 14:10:48 ethan/sxummoow b5f0af21
│ Use the feature
○ vqpzktsp ethan@example.com 2026-11-15 14:06:27 ethan/vqpzktsp fe52c25f
│ Implement the feature
○ oomyzqmz ethan@example.com 2026-11-15 14:01:19 ethan/oomyzqmz 07f69717
│ Refactor for the feature
~
最初の変更を実装した後、レビューのためにPRを公開し、すぐに次の変更の作業を開始できます。ワークストリームは長いキューになり、PRがマージの準備ができたら一番下からポップオフし、パイプラインの停滞なしに一番上にプッシュされます。
jjとGitHubで小さなPRスタックを手動で設定するのは非常に簡単ですが、このテクニックにハマったら(スタックを5〜10PRの深さにすること)、ツールが必要になります。jj-pancakeは、スタックされたPRツールのリングへの私の参入です。詳細は近日公開予定です。
リソース
- 公式Jujutsuドキュメント。私は最も頻繁にrevset仕様を参照します。
- Steve Klabnikの
jjチュートリアルは、私が最初にjjを知ったきっかけでした。永続的なリソースとして維持されているとは思いませんが(私のものも保証しません!)、それでも良い読み物です。 jjのリリースRSSフィードをフォローしています。最近のリリースは新機能で満載です。全体的にjjは非常に安定していますが、時折のバグは迅速に修正されます。- Jujutsu Discordは活発でフレンドリーです!
- East River Source Controlのブログ。Jujutsuをうまくサポートするように設計された新しいフォージとコードレビュープラットフォームを構築している会社です。Jujutsuの作成者であるMartin von ZweigbergkがCTOとして参加しており、他にも多くの優秀な人材がいます。おそらくいつかGitHubの後継となるでしょうか?私は彼らを応援しています。
- 私の個人的な
jj設定。便利なエイリアスやトリックが見つかるかもしれませんが、読みやすくしようとはしていません。 jjメンテナーであるAustin Seippのjj設定。クールなトリックが含まれています。