jj入れ子コマンド エイリアス設定で解決

バージョン管理システム「jj」（Jujutsu）は、Gitの代替として近年注目を集めている。変更履歴を直感的に操作できる点が評価され、開発者の間で採用が進む。しかし、そのコマンド体系には小さな落とし穴が存在する。jjという短いコマンド名ゆえ、習慣的に重ね打ちしてしまうケースだ。本稿では、この問題をjj自身の設定機能で解決する手法を紹介する。

問題の所在

jjユーザーがコマンドラインでjj showと入力しようとした際、無意識にjj jj showとタイプしてしまうことがある。これはjjに限らず、git git statusのような入力ミスと同種のものだ。jjの場合、この余分なjjはサブコマンドとして解釈され、「unrecognized subcommand ‘jj’」というエラーが返される。変更IDを取得するためにjj jj show -T 'change_id.short()'と入力した場合、以下のような出力となる。

$ jj jj show -T 'change_id.short()'
error: unrecognized subcommand 'jj'
Usage: jj [OPTIONS] <COMMAND>
For more information, try '--help'.

このエラーを回避するには、シェルのエイリアスを設定する方法もある。しかしjj自体がgitと同様に設定ファイルでのエイリアス定義をサポートしている点に着目したい。さらに、jj util execというサブコマンドを組み合わせることで、余分なjjを吸収できる。

設定ファイルへのエイリアス定義

jjの設定ファイルはjj config editで直接編集可能だ。jj config setを使えばシェルからも設定を変更できる。ここにエイリアスを追加する。基本的な考え方は、余分なjjをエイリアスとして定義し、jj util exec経由で本来のコマンドを実行させるというものだ。

最初の試みとして、以下の設定を記述する。

[aliases]
jj = ["util", "exec", "jj"]

これは、jjというエイリアスがutil exec jjを実行するよう指示する。シェルが最初のjjを解釈し、2つ目のjjがエイリアスとして評価され、残りの引数（たとえば["show", "-T", "change_id.short()"]）がそのまま渡される仕組みだ。しかし、この設定では新たな問題が発生する。

$ jj jj show -T 'change_id.short()'
error: unexpected argument '-T' found
tip: to pass '-T' as a value, use '-- -T'
Usage: jj util exec [OPTIONS] <COMMAND> [ARGS]...
For more information, try '--help'.

-Tという引数がjj util exec自身のオプションとして解釈されてしまった。jj util execは実行するコマンドとその引数を取るが、--で区切らない限り、後続の引数をすべてコマンドに渡すわけではない。-Tはjj util execのオプションと認識され、エラーとなる。

引数問題の回避策

この問題を解決するには、Unix系コマンドで標準的な「--」を使う。--以降の引数はすべてオプションとして解釈せず、そのままコマンドに渡すという明確な区切りだ。エイリアス定義を以下のように修正する。

[aliases]
jj = ["util", "exec", "--", "jj"]

この設定により、jj util exec -- jjという動作になる。--以降のすべての引数（show, -T, change_id.short()）はjjコマンドにそのまま渡される。-Tが誤って解釈されることはなくなる。

動作確認と実用性

修正後のエイリアス設定でテストを行う。任意の数のjjを重ねても、正しく動作することを確認できる。

$ jj show -T 'change_id.short()'
upvqxuzzvxtx
$ jj jj show -T 'change_id.short()'
upvqxuzzvxtx
$ jj jj jj jj jj show -T 'change_id.short()'
upvqxuzzvxtx
$ jj jj jj jj jj jj jj jj jj jj jj jj jj jj jj jj jj show -T 'change_id.short()'
upvqxuzzvxtx

これらの出力はすべて同一の変更IDを返している。どんなにjjを入れ子にしても、エラーが発生せずに意図したコマンドが実行される。この設定は、慌ててタイプミスをした場合や、シェルの補完機能に頼らず手打ちする場面で特に有用だ。

設定の適用範囲

このエイリアスは、jjのグローバル設定に記述すればシステム全体で有効になる。プロジェクト固有の設定に書けば、そのリポジトリ内でのみ適用される。jj config set --user aliases.jj '["util", "exec", "--", "jj"]'のようにシェルから直接設定することも可能だ。

注意点として、このエイリアスはjjという文字列自体を書き換える。そのため、本来のjjサブコマンドとしての挙動とは異なる点に留意が必要だ。たとえば、jj jjと入力した場合、エイリアスが展開されてjj util exec -- jj util exec -- jjのように無限ループに陥る可能性がある。しかし、実際のテストではそのような事態は発生していない。jj util exec -- jjは引数としてjjを受け取り、それをシェル経由で実行するため、再帰的な展開は起こらない。ただし、この点は将来のバージョンで挙動が変わる可能性がある。

類似事例との比較

この手法は、「Git git git git git」問題の解決法と類似している。Gitでもエイリアス設定と--を使って同様の対策が可能だ。jjはGitと比較して、設定ファイルでのエイリアス定義がより直感的である。jj util execというコマンドが用意されている点も、この問題の解決を容易にしている。

一方で、シェルのエイリアスを使う場合、alias jj='jj'のように単純に同じコマンドを再実行する設定では、入れ子問題は解決できない。再帰的なエイリアス展開を防ぐ必要があるためだ。jjの設定エイリアスなら、その点を気にせずに定義できる。

まとめ

jjの設定ファイルにエイリアスを追加し、--で引数を適切に渡すことで、うっかり重ねて入力したjjを無視させられる。この小技は、コマンドラインでのストレスを軽減し、作業効率を高める。特に、jjを使い始めたばかりの開発者や、タイピングミスが多い環境では導入価値が高い。

設定はわずか1行、変更も即座に反映される。jj config editを開いて上記のエイリアスを追記するだけで完了する。試用後も問題がなければそのまま使い続けられる。jjの柔軟な設定機構を活用した、実用的なTipsと言える。

編集部の見解

jjのこのエイリアス設定は、コマンドラインインタフェースのユーザビリティ向上という観点から評価できる。短期間では、jjユーザーのタイプミスによるストレスが軽減され、特に初心者がjjに感じる敷居の高さを下げる効果が期待される。また、類似の入れ子問題に悩む他のCLIツールにも応用可能なテクニックだ。

長期的視点では、バージョン管理ツールの設定の柔軟性が、ユーザーの定着率に影響を与える要素となる。jjはGitと比較して設定エイリアスが簡潔に記述でき、この点は競争優位性として機能する可能性がある。jjのエコシステムが拡大するにつれて、こうした細かな工夫がコミュニティ内で共有され、ドキュメント化されていくことが望ましい。

編集部としては、jjのエイリアス機能がどの程度の深さまで設定可能か、また他のサブコマンド（たとえばjj git関連の操作）でも同様の入れ子問題が発生しないのか、検証の余地があると考える。特に、jj util execの挙動はバージョンアップで変化する可能性があるため、継続的な追跡が必要だ。

参考

• Lobsters — 2026-06-30T22:16:39.000Z公開