Jujutsu (jj) — 成功のPit

使用時機

以下の場合にアクティベートします:

• 「jjの使い方」「jjワークフロー」「jujutsuチュートリアル」と聞かれた場合
• 「Xのためのjjコマンドは?」と言われた場合(Xはgit同様の操作)
• jjのインストール/セットアップやgitからの移行を希望する場合
• revsets、テンプレート、ブックマーク、またはコンフリクト解決に関するヘルプが必要な場合
• jjエラー、コンフリクト、またはダイバージェンスが発生した場合
• 特定のトピックについてさらに深く掘り下げるには references/ ファイルを参照

クイックスタート

brew install jj                                    # macOS
jj config set --user user.name "Your Name"
jj config set --user user.email "you@example.com"
source <(COMPLETE=zsh jj)                          # dynamic completions

Git >= 2.41.0が必要です。

コアコンセプト

ワーキングコピーはコミット

JJはすべてのコマンドでワーキングコピーを自動スナップショット化します。git add は不要です。コミット @ はワーキングコピーです。

• jj st — ステータス(変更がある場合は自動コミットを作成)
• jj commit — 説明を設定して新しい空のチャイルドコミットを作成
• jj new — 新しい空のチャイルドコミットを作成
• jj describe — 説明のみを編集

Change ID vs Commit ID

ID	安定性	用途
Change ID (kntqzsqt)	YES — リベース/修正後も保持	進行中の作業の参照
Commit ID (7fd1a60b)	NO — リライト時に変更	コンテンツハッシュ (Git SHA)

ブックマーク ≠ Gitブランチ

ブックマークは jj new で自動的には進まりません。明示的に移動させます:

jj bookmark create feat -r @   # 作成
jj bookmark move feat --to @   # 進める

ファーストクラスのコンフリクト

リベース/マージは中断されません。コンフリクトはコミットに保存されます。準備ができたら解決します:

jj new <conflicted-commit>   # チェックアウト
# コンフリクトマーカーを編集
jj squash                    # 解決をコミットに移動

オペレーションログ

すべての変更がログに記録されます。完全な安全ネット。

jj op log           # すべてのオペレーション履歴
jj undo             # 最後のオペレーションを元に戻す
jj op restore <id>  # 任意のポイントに復元
jj --at-op <id> log # 過去の状態の読み取り専用ビュー

CLIヘルプ & ディスカバリー

jj --help          # すべてのコマンド
jj help <command>  # 完全なヘルプ
jj <command> -h    # 簡潔なヘルプ
jj help revsets    # revset言語ドキュメント
jj help templates  # テンプレート言語

一貫性のあるフラグ

フラグ	短縮形	用途
--revision	-r	これらのリビジョンを選択
--source	-s	リビジョン + すべての子孫
--branch	-b	トポロジカルブランチ全体
--from / --to	-f / -t	コンテンツのソース/デスティネーション
--onto	-o	このリビジョンの子として配置
--insert-after	-A	リビジョンとその子の間に挿入
--insert-before	-B	リビジョンとその親の間に挿入
--change	-c	自動生成されたブックマーク付きでプッシュ

ショートカット

jj b = jj bookmark、jj b c = jj bookmark create、jj b l = jj bookmark list、jj b m = jj bookmark move

成功のPit — 日常ワークフロー

jj git clone https://github.com/user/repo      # 開始
jj describe -m "my feature"                     # メッセージを設定
# ファイルを編集...
jj commit                                       # このチェンジを完了、次を開始
# ... 後ほど、GitHubにプッシュ:
jj git push -c <change-id>                      # 自動でブックマークを作成、プッシュ

リモートから更新するには:

jj git fetch
jj rebase -b @ -o main                          # あなたの作業を最新のmainにリベース

古いコミットを修正するには:

# ワーキングコピーで変更を行う
jj squash --into <target-change-id>

完全なワークフロー詳細は references/workflows.md を参照してください。

リファレンスファイル

ファイル	内容
references/workflows.md	13個の日常ワークフローすべてと例
references/revsets.md	完全なrevset言語: 演算子、関数、パターン
references/templates.md	テンプレート言語: 型、フィールド、式、設定
references/git-command-table.md	完全なgit→jjコマンドマッピング(35以上の翻訳)
references/config.md	設定リファレンス: キー、例、macOSテンプレート

注意点

1. ブックマークは自動的には進まない — gitブランチと異なり、jj bookmark move を使用します。
2. 隠されたコミット — リライトされたコミットは隠されていますが、まだ存在します(コミットIDでアクセス可能)。
3. ダイバージェントなチェンジ — 同じチェンジIDがローカルとリモートの両方でリライトされています。修正: jj new <change-id> を実行してから不要な側を jj abandon します。
4. コロケーション — jj はgitをデタッチHEAD状態に置きます。gitコマンドを実行する前に git switch <branch> を実行してください。
5. jj commit ≠ git commit — jj commit はメッセージを設定して新しい空のチャイルドコミットを作成します。メッセージのみを編集するには jj describe を使用してください。
6. 自動スナップショット — すべてのコマンドはワーキングコピーをスナップショット化します。進行中の作業を保存するには jj new @- を使用してください。
7. ステージングエリアなし — git add -p の代わりに jj split または jj squash -i を使用してください。
8. jj git push -c はブックマークを作成 — 自動的にブックマーク名を生成します。既存のブックマークには jj git push --bookmark <name> を使用してください。