メインコンテンツまでスキップ

タスクに合わせてシェルを移動する

シェル連携を使うと、gji new、gji go、gji back で選択したワークツリーに移動できます。通常の CLI プロセスは親シェルのディレクトリを変えられないため、小さなシェルラッパーが最後の移動を行います。

一度だけインストールする​

gji init

シェルを再起動するか、ウィザードが示した rc ファイルを読み込んでください。その後、確認します。

gji doctor

ウィザードはラッパーと補完を設定し、エディタの保存も案内します。シェルを指定する場合は、次のうち 1 つを実行してください。

gji init zsh --write
gji init bash --write
gji init fish --write

現在のセッションで試す​

zsh または bash では、rc ファイルに書き込まずにラッパーを読み込めます。

eval "$(gji init zsh)"
# In bash, use: eval "$(gji init bash)"

fish では次のようにします。

gji init fish | source

ラッパーを先に確認するには、--write を付けずに gji init zsh、gji init bash、gji init fish を実行してください。

普段のコマンドで移動する先​

コマンドシェルの移動先
gji new feature/search新しいタスクのワークツリー
gji pr 1234PR のワークツリー
gji go feature/payments既存の移動先ワークツリー
gji back前に訪れたワークツリー
gji rootメインリポジトリのチェックアウト

移動しても未コミットの変更は転送されません。変更を加えたワークツリーに残ります。

移動先のパスだけが必要な場合、シェル連携は不要です。

gji go --print feature/payments
gji root --print

たとえば zsh や bash では、次のように使えます。

cd "$(gji go --print feature/payments)"

更新後に読み込み直す​

シェルを再起動するか、上記のセッション用コマンドでラッパーを読み込み直してください。gji go がまだ移動せずにパスだけを出力する場合は、実際に使っているシェルで連携を読み込んだか確認してください。トラブルシューティングもご覧ください。