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

ワークツリーをプロジェクトに合わせる

まずは既定値で使ってみてください。同じセットアップを繰り返したり、毎回同じエディタを選んだり、同じローカルファイルをコピーしたりするようになったら、設定を追加します。

設定の保存先を選ぶ​

場所用途
~/.config/gji/config.json複数のリポジトリで使う個人の既定値
そのグローバルファイル内の repos 項目非公開のローカルファイル名など、1 つのリポジトリに対する個人設定
リポジトリ内の .gji.jsonチームで共有するプロジェクトの既定値

設定は、グローバルの既定値、グローバルのリポジトリ別設定、ローカルの .gji.json の順に適用します。後の階層が前の値を上書きします。フックはイベントのキー単位で統合し、同じイベントは後の階層で上書きします。

エディタやブランチの接頭辞を保存する​

gji open --editor cursor --save
gji config set branchPrefix feature/

インストール済みのエディタ CLI を指定してください。config が編集するのはグローバルの既定値です。

gji config get
gji config get branchPrefix
gji config unset branchPrefix

非公開のローカルファイルをコピーする​

今後作成するワークツリーでそのファイルが必要なリポジトリ内で実行してください。

gji sync-files add .env.local .npmrc
gji sync-files list
gji sync-files remove .npmrc

一覧はグローバル設定の該当リポジトリの項目に保存します。新しいワークツリーには、依存関係のセットアップ前にメインワークツリーからファイルをコピーします。コピー元にないファイルは無視し、コピー先の既存ファイルは上書きしません。作成時のコピーであり、継続的な同期ではありません。

共有するプロジェクトファイルには、代わりに .gji.json の syncFiles を使ってください。

{
"syncFiles": [".env.example", ".nvmrc"]
}

依存関係の初期セットアップ​

新しいワークツリーは独自の依存関係を持ちます。gji new または gji pr が対応するロックファイルを検出すると、プロジェクト内で適切なセットアップを実行します。

プロジェクトセットアップ
pnpm, Yarn, Bun, npmJavaScript の依存関係をインストールします
uv, Poetry, PipenvPython 環境をインストールします
Bundlervendor/bundle にインストールします
Composervendor にインストールします
Gogo mod download
Cargocargo check、または dependencyBuildCommand

依存関係ツリーやビルドキャッシュをワークツリー間でコピーすることはありません。セットアップには時間がかかる場合があり、対応するツールとリモートへのアクセスが必要です。設定したローカルファイルを先にコピーし、セットアップが成功した後で afterCreate フックを実行します。

1 回だけインストールを省略するには、次のようにします。

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

リポジトリで無効にするには、.gji.json に次を設定します。

{
"dependencyBootstrap": "off"
}

gji new feature/search --dry-run で作成計画を確認できます。JSON や非対話のコマンドでも、無効にしない限り同じ依存関係のセットアップを行います。失敗したときはタスクを作り直さず、表示されたワークツリーのパスで復旧してください。トラブルシューティングをご覧ください。

ワークツリーの保存先を選ぶ​

既定は ../worktrees/<repo>/<branch> です。別の基準ディレクトリが必要なリポジトリでは、.gji.json またはグローバルのリポジトリ別設定に worktreePath を指定します。

{
"worktreePath": "~/worktrees/my-repo"
}

ブランチはその基準パスの配下に置きます。feature/search なら ~/worktrees/my-repo/feature/search になります。絶対パスまたは ~/ で始まるパスを使ってください。相対パスは警告を表示して無視します。この設定は今後の作成に適用し、既存ワークツリーの場所は変えません。

別の同期先を使う​

{
"syncRemote": "upstream",
"syncDefaultBranch": "main"
}

gji sync の同期先と、gji new --branch-only が使うリモートの既定ブランチを指定します。同期と削除をご覧ください。

個人のリポジトリ別設定を Git に含めない​

~/.config/gji/config.json に設定します。

{
"repos": {
"/home/me/code/my-repo": {
"editor": "zed",
"syncFiles": [".env.local"],
"hooks": {
"afterCreate": ["pnpm", "run", "generate"]
}
}
}
}

リポジトリの項目には絶対パスを使ってください。指定したリポジトリだけに、その設定を適用します。

設定キーの一覧​

キー用途
branchPrefixfeature/ など、新しいブランチ名の接頭辞
editoropen と new --open の既定エディタ CLI
worktreePath新しいワークツリーの基準ディレクトリ。絶対パス、または ~/ で始まるパス
syncRemote同期に使うリモート
syncDefaultBranch同期先に使う既定ブランチ
syncFiles作成時にメインワークツリーからコピーするファイル
dependencyBootstrap自動依存関係セットアップを無効にするには off を指定します
dependencyBuildCommand任意の Cargo セットアップコマンド。既定は cargo check
shellIntegrationウィザードで保存したシェル設定の選択
installSaveTargetウィザードの設定をローカルとグローバルのどちらに保存するか
hooks作成、移動、切り替え、削除に使うライフサイクルコマンド
reposグローバル設定にあるリポジトリ別の上書き設定