タスクを切り替えても、作業はそのまま。
レビューを頼まれるたびに、開発途中の作業を片付ける必要はありません。gji はタスクごとに独立した作業ディレクトリを用意し、シェルから移動できるようにする Git ワークツリー CLI です。
タスクごとに残るもの
作業ファイル、インストールした依存関係、生成ファイルは、そのタスクのディレクトリに置かれます。新しい機能、PR レビュー、実験のために別のワークツリーを開いても、元のワークツリーのファイルはそのまま残ります。
# While working on feature/payments:
gji new feature/search
gji pr 1234
gji go feature/payments
1234 は、利用しているリポジトリの実際の GitHub PR 番号に置き換えてください。シェル連携を有効にしていれば、最後のコマンドで feature/payments に戻れます。残しておいた未コミットの変更もそのままです。
各ワークツリーでは、いつもの Git コマンド、エディタ、コーディングツールを使えます。gji が扱うのはワークツリーの作成、移動、セットアップ、削除です。コミットやレビューの手順を置き換えるものではありません。
こんなときに役立ちます
- 機能開発に未コミットの変更があるまま、PR をレビューする必要があるとき。
- 使用中のチェックアウトを変えずに、アイデアを試したいとき。
- 複数のブランチで異なる依存関係や生成ファイルが必要なとき。
- 人が進めるタスクと AI を使うタスクを並行して開き、それぞれのファイルを分けたいとき。
Git ワークツリーはリポジトリの履歴と参照を共有します。コンテナではないため、サービス、ポート、外部データベースなどのマシン上のリソースは、プロジェクト側で分離または設定する必要があります。また、ワークツリーごとにファイルと依存関係を置くディスク容量を使います。
最初に確かめること
gji をインストールしてシェル連携を有効にしたら、クイックスタートを試してください。ワークツリーを作り、元のワークツリーに戻って、ファイルが残っていることを確認します。
その後は、目的に応じて次のドキュメントをご覧ください。