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

タスクを開いたままにする

中断して戻る必要のあるタスクごとに、ワークツリーを用意してください。以下のコマンドは、シェル連携を読み込んだ状態を前提としています。

機能開発を始める​

gji new feature/search

ブランチとワークツリーを作成し、対応する依存関係のセットアップを実行して、シェルをそのディレクトリへ移動します。元のワークツリーのファイルは残ります。

同時にエディタも開くには、次のようにします。

gji new feature/search --open --editor cursor

必要に応じて code、zed など、インストール済みのエディタ CLI を選んでください。gji open --editor cursor --save で既定値を保存すれば、--editor は省略できます。

既定では、新しいブランチはメインワークツリーから作成します。現在のワークツリーのコミットを含める場合は、次のようにします。

gji new feature/search-tests --from-current

現在のワークツリーの HEAD を使います。未コミットのファイルは引き継ぎません。そのファイルを意図的に新しいワークツリーへ移すには --take を使ってください。元にも残す場合は --copy を追加します。

gji new feature/search-fix --take
gji new feature/search-copy --take --copy

必要な結果に合うコマンドを、どちらか 1 つ選んでください。

変更を片付けずに PR をレビューする​

gji pr 1234
# Or: gji pr https://github.com/org/repo/pull/1234

自分のリポジトリの実際の PR 番号か URL を使ってください。レビュー専用のワークツリーを作成し、依存関係もセットアップします。戻るには次を実行します。

gji back

現在のワークツリーの PR を Web で開くには、次のようにします。

gji pr open

別のリンクされたワークツリーの PR を選ぶには gji pr open --select を使います。

開いているタスクを見つける​

gji # see the repository hub
gji go # choose a destination
gji go feature/payments # go to a known branch
gji back # return to the previous worktree

選択画面は現在のリポジトリから始まります。Tab を押すと、登録済みのすべてのリポジトリを対象にできます。/ でブランチ、パス、PR、タスクの説明を検索します。同じブランチ名が複数のリポジトリにある場合は repo/branch を使ってください。

gji go api/main

さらに前の移動履歴は gji history と gji back 2 でたどれます。メインリポジトリのチェックアウトに戻るには gji root を使います。

エディタを開いてタスクに説明を付ける​

gji open
gji task "Add payment retries"

タスクの説明は対話的な選択画面に表示されるため、ブランチ名だけですべてを伝える必要はありません。gji task --clear で消せます。

gji open は現在のワークツリーを対象とします。別のワークツリーを選ぶには gji open --select、直接指定するには gji open feature/payments を使ってください。VS Code、Cursor、Windsurf では、--workspace が .code-workspace ファイルを生成してから開きます。

実験用のファイルを分ける​

gji new --detached

ブランチに属さないワークツリーを使えば、最初にブランチ名を決めずに調査できます。コミットを名前のあるブランチに残したい場合は、その前に Git でブランチを作ってください。--detached と --from-current は併用できません。

コーディングエージェントにはタスクごとに別のワークツリーを用意し、そのディレクトリで普段のツールを起動してください。ワークツリーが分けるのはファイルです。共有サービス、データベース、待ち受けポートは分離しません。

別のディレクトリが不要ならワークツリーを再利用する​

gji new feature/next-task --branch-only

現在のワークツリーに変更がないことが必要です。設定されたリモートの既定ブランチを更新し、新しいワークツリーや依存関係のセットアップなしで、その場にブランチを作成します。ローカルの既定ブランチを使う場合は --no-fetch を指定してください。

順番に進める作業で使ってください。別の場所で作業する間も元のタスクを開いておきたい場合は、別のワークツリーを使います。

タスクを更新、または完了する​

gji sync

リモートの変更を取得し、現在のブランチを設定された既定ブランチの上へリベースします。タスクを終えて削除する前に、ファイルとブランチの状態を確認してください。

gji done feature/search

削除時にはワークツリーとブランチの両方を削除する場合があります。--keep-branch、事前確認、取り消しの限界については、同期と削除をご覧ください。