よくある質問
別のタスクを開く前にコミットやスタッシュが必要ですか?
別のワークツリーを使うなら必要ありません。gji new や gji pr が別の場所でタスクを開いても、変更は元のディレクトリに残ります。ただし、gji new --branch-only は現在のワークツリーを再利用するため、変更がないことが必要です。
移動すると変更も別のブランチへ移りますか?
いいえ。go と back は場所を変えるだけで、ファイルはそれぞれのワークツリーに残ります。未コミットの変更を意図的に新しいタスクへ移すには gji new <branch> --take を使います。両方に残すには --copy を追加してください。
ワークツリーごとに何を分離しますか?
作業ファイル、インストールした依存関係、生成ファイルを別々のディレクトリに置きます。Git の履歴と参照は共有します。サービス、ポート、データベースなどの外部リソースには、引き続きプロジェクト固有の設定が必要です。
普段のエディタやコーディングエージェントを使えますか?
はい。ワークツリーに入り、その場所で普段のツールを起動してください。gji open でインストール済みのエディタを開くこともできます。並列エージェントに別々のファイルで作業させたい場合は、タスクごとにワークツリーを分けてください。gji はエージェントの管理や調整は行いません。
なぜシェル連携が必要ですか?
CLI プロセスは親シェルの作業ディレクトリを変更できません。ラッパーがその部分を受け持ちます。gji init を実行してシェルを再起動し、gji doctor で確認してください。シェル連携をご覧ください。
ラッパーなしでも使えますか?
はい。ワークツリーの作成や確認は通常どおり使えます。スクリプトでパスが必要な場合は gji go --print <branch> や gji root --print を使ってください。ディレクトリの自動移動にはラッパーが必要です。
ワークツリーはどこに作られますか?
既定の場所は次のとおりです。
../worktrees/<repo>/<branch>
メインのチェックアウトの外側に、ブランチごとの予測可能なパスで作成します。既存のディレクトリは gji ls で確認してください。
ワークツリーごとに依存関係をインストールしますか?
新しいワークツリーには独自のインストール状態が必要です。対応するロックファイルがあると自動でインストールし、別のワークツリーの依存関係ツリーはコピーしません。初回のセットアップには時間がかかる場合があります。1 回だけ省略するには --no-install、リポジトリで無効にするには dependencyBootstrap を off に設定してください。依存関係の初期セットアップをご覧ください。
新しいワークツリーに .env.local を用意するには?
gji sync-files add .env.local
今後作成するワークツリーには、依存関係のセットアップ前にメインワークツリーからコピーします。その後、同期し続けるわけではありません。ローカルファイルの設定をご覧ください。
どの PR 形式を指定できますか?
gji pr は GitHub PR 番号、引用符で囲んだ '#1234'、完全な GitHub PR URL を受け付けます。作業中のリポジトリに属する参照を使ってください。
設定はどこに保存しますか?
個人の既定値は ~/.config/gji/config.json に保存します。その中のリポジトリ別の項目を使えば、個人設定を Git に含めずに済みます。共有するプロジェクトの既定値には .gji.json を使ってください。設定をご覧ください。
ワークツリーを作り直さずにセットアップをやり直せますか?
依存関係をセットアップするには、そのディレクトリ内でプロジェクトのインストールコマンドを実行します。設定済みフックを再実行するには gji run-hook afterCreate を使ってください。フックのコマンドは、組み込みの依存関係アダプタを再実行しません。
削除したファイルを取り消しで復元できますか?
記録されたブランチとワークツリーの状態は復元できますが、未コミットのファイルや未追跡のファイルは復元できません。特に --force を使うときは、削除前に内容を確認してください。同期と削除をご覧ください。