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

作業に戻るために

まず、問題が起きているリポジトリ内で診断します。

gji doctor

Git、シェル、設定に関する案内を確認してください。以下では、よくある症状と対処方法を説明します。

gji go が移動せずにパスを表示する​

そのセッションでシェルラッパーを読み込んでいません。zsh では次のようにします。

eval "$(gji init zsh)"

bash では zsh を bash に置き換えてください。fish では gji init fish | source を実行します。もう一度 gji go を試してください。設定を保存するには gji init を実行し、シェルを再起動してから gji doctor で確認します。

シェルを指定したインストールやスクリプト専用の使い方については、シェル連携をご覧ください。

ワークツリーはあるのに依存関係がない​

ワークツリーの作成が完了した後に、依存関係のセットアップが失敗する場合があります。エラーに表示されたパスから、作成済みのワークツリーに入ってください。インストールをやり直すためだけに削除して作り直す必要はありません。

その場所で、プロジェクトの通常のインストールコマンドを実行します。たとえば、次のようにします。

pnpm install

パッケージマネージャが使えることと、レジストリへアクセスできることを確認してください。インストールの失敗により afterCreate が実行されなかった場合は、必要に応じて設定済みのフックを再実行します。

gji run-hook afterCreate

再実行したいコマンドだけを実行してください。フックには副作用がある場合があります。フックのコマンド自体は、自動の依存関係インストールを再実行しません。

対応するロックファイルがない場合は、プロジェクト固有のセットアップ用フックを設定するか、手動でインストールしてください。対応ツールは依存関係の初期セットアップをご覧ください。

依存関係のセットアップを省略したい​

1 つのタスクで省略するには、次のようにします。

gji new feature/search --no-install
gji pr 1234 --no-install

リポジトリで無効にする場合は、.gji.json の dependencyBootstrap を off に設定してください。

ローカルのセットアップ用ファイルがコピーされない​

設定されている一覧を確認してください。

gji sync-files list

コピー元のファイルは、現在のワークツリーだけでなく、メインワークツリーにある必要があります。コピー元にないファイルは無視し、コピー先の既存ファイルは上書きしません。一覧の変更は今後のワークツリーに適用します。継続的にコピーするわけではありません。ローカルファイルをご覧ください。

sync が実行を拒否する、またはリベースが止まる​

gji status
git status --short

ローカルの変更があるか、HEAD がブランチから切り離されている可能性があります。同期の前にローカルの変更を整理するか、ブランチ付きのワークツリーに移動してください。すでにリベース中なら、普段の Git の手順(git rebase --continue または git rebase --abort)で解決してから再試行します。

PR をローカルで開けない​

番号や URL が現在のリポジトリに属していることと、現在の認証情報で Git リモートにアクセスできることを確認してください。gji pr は PR の参照を取得するもので、非公開リポジトリへのアクセス権を付与するものではありません。

ファイルを作らずに計画を確認するには、次を実行します。

gji pr 1234 --dry-run

登録されたリポジトリがすでに存在しない​

古い登録情報を確認してください。

gji doctor --fix

対話モードでは、存在しないリポジトリの登録情報を削除する前に確認します。確認済みの修正を非対話モードで適用するには、gji doctor --fix --yes を使ってください。Git、エディタ、シェルの設定を自動修復するものではありません。

ワークツリーの削除が拒否される​

ローカルの変更、未マージのブランチ、現在または主ワークツリーでないかを確認してください。ディレクトリだけを削除する場合は、gji done <branch> --keep-branch でブランチを残します。

警告を消すためだけに --force を使わないでください。未コミットのファイルや未マージのブランチを削除する場合があります。先に削除と復元を読んでください。gji undo --list は復元できる記録済みの操作を表示しますが、未コミットのファイルは復元できません。

スクリプトでパスだけを取得したい​

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

これらのコマンドにはシェルラッパーは不要です。構造化された状態を取得する場合は、対応するコマンドの --json を使ってください。コマンドをご覧ください。