バージョン管理：組み込みの Git パネル

今日は金曜日です。月曜日にプロジェクト計画のノートを書き直し、セクションを2つ丸ごと削除しました。いま、そのうちの1段落が必要になりましたが、4日前の操作なので「元に戻す」はもう使えません。ワークスペースが Git リポジトリなら、30秒で済みます。履歴を開き、月曜日のコミットを見つけ、差分から以前の文章を読むだけです。

Consilience には、VS Code の Git ビューに似た完全なソース管理パネルが組み込まれています。アプリを離れずに、変更の確認、ステージ、コミット、プッシュ、プルができます。AI にコミットメッセージを書かせることもでき、ブランチ、スタッシュ、色分けされたレーン付きのコミットグラフも同じパネルにまとまっています。

パネルを開き、リポジトリを作る

パネルを開く方法は3つあります。

• タイトルバー：左上のセグメントコントロールで、チャットとファイルツリーの隣にあるブランチアイコンのセグメント（ツールチップは「ソース管理」）を選びます。
• メニューバー：移動 → ソース管理を選びます。既定のキーボードショートカットはありません。
• コマンドパレット：「ソース管理を表示」を実行します。

パネルは、開いているワークスペースのフォルダ、またはその上位にある任意のフォルダでリポジトリを探します。そのため、大きなリポジトリ内のサブフォルダをワークスペースにしても問題ありません。リポジトリがまったくない場合は、「このフォルダーは git リポジトリではありません。」という空の状態と、「リポジトリを初期化」（git init を実行）、「GitHub に公開」（後述する一括フロー）の2つのボタンが表示されます。Git がまだインストールされていない場合もアプリが検出し、「Git を入手」ボタンからダウンロードページを開けます。

ステージ、コミット、プッシュ

変更一覧は VS Code と同じ考え方でファイルをグループ化します。空でないグループだけが表示され、件数バッジと、ホバー時に現れる操作が付きます。各行にはファイル名、薄く表示されたフォルダ、+N/−N の行数、色付きのステータス文字が並びます。M は変更、A は追加、D は削除、R/C は名前変更またはコピー、T は種類変更、U は追跡対象外（緑）または競合（オレンジ）です。

Git のコミットは2段階です。行にホバーして + をクリックし、まずステージします。次にメッセージを書いて「コミット」を押します。両方がそろうまではボタンが無効で、ツールチップに不足しているものが「コミットする前に変更をステージしてください。」または「先にコミットメッセージを入力してください。」と表示されます。

メッセージを書く手間を省きたい場合は、テキスト欄のきらめきアイコン、「コミットメッセージを生成」をクリックします。ステージ済みの差分が AI に送られ、Conventional Commits 形式のメッセージが入力されます。「コミット」の隣にある山形アイコンからは、「コミットしてプッシュ」と「コミット (修正)」を選べます。フッターの「変更を同期」ボタンは、プルしてからプッシュする処理を一度に実行します。

docs(plans): fold Q3 scope cuts into the decision log

ステージ

Git の2段階コミット。最初に変更をインデックスへ選び（+ の操作）、ステージ済みの内容だけをコミットします。Consilience がステージされていない作業をコミットすることはありません。

ハンク（ブロック）

差分内で連続している変更行のまとまり。差分タブでは、各ブロックに個別のステージ、ステージ解除、破棄ボタンが付きます。

スタッシュ

未コミットの作業を一時退避する Git の仕組み。「スタッシュ」コマンドでも、アプリの「破棄」でも変更はここに入り、「適用して削除」で戻せます。

アップストリーム

ローカルブランチの同期先となるリモートブランチ。設定されるまでは「変更を同期」ではなく公開操作が表示され、最初のプッシュで自動設定されます。

コミットグラフ

パネルの「グラフ」セクション。すべての参照（ブランチとタグ）にまたがる最近のコミットを、色付きのブランチレーンと参照ピルで描画します。

差分タブ：ブロック単位で作業する

変更された行をシングルクリックすると、読み取り専用の差分が通常のタブとして開きます。作業ツリーの編集は filename (変更)、インデックスは filename (ステージ済み) と表示され、同じファイルの両方を同時に開くこともできます。（ダブルクリックすると、ファイル自体が開きます。）

既定のレイアウトは左右比較で、変更のない領域は展開可能な区切りの中へ折りたたまれます。フローティングツールバーでは、変更間を移動（F8 / Shift+F8）し、左右比較とインライン表示を切り替えられます。右端の概要ルーラーには、すべての変更がクリック可能な色付きの点で示されます。

• 作業ツリーの差分では、変更ブロックごとにガターへ +「このブロックをステージ」と ⟲「このブロックを破棄」が表示されます（確認：「このブロックを破棄しますか？変更は失われます。」）。
• ステージ済みの差分では、代わりに −「このブロックをステージから外す」が表示されます。
• これを使えば、雑多な変更を含む1つのファイルを2つの明確なコミットへ分けられます。関連するブロックだけをステージしてコミットし、その後に残りをステージします。
• 補足：すべての Markdown エディターとコードエディターには、Git の HEAD と異なる行を示す差分ガターバーも表示されます。追加は緑、削除は赤で、入力のたびに再計算されます。

ブランチと履歴

フッターのブランチボタンには、現在のブランチ名（ブランチではなくコミットをチェックアウトしている場合は「(ブランチなし)」）と、behind/ahead の件数 ↓N ↑N が表示されます。クリックするか、… → ブランチ →「チェックアウト先…」を選ぶと、ブランチ選択画面が開きます。そこでは検索と作成が1つの入力欄（「ブランチを検索または作成…」）を共有します。新しい名前を入力して Enter を押すと、「ブランチ "{name}" を作成」します。ローカルブランチをクリックするとチェックアウトし、「リモート」から選ぶとローカルの追跡ブランチが作られます。

ブランチにホバーすると削除ボタンが現れます。ブランチがマージされていない場合、Git は通常の削除を拒否し、ダイアログが「ブランチが未マージ」に切り替わります。赤い「強制削除」ボタンは、その作業を完全に失うことを警告します。

下部の「グラフ」セクションには、すべての参照にまたがる最近の履歴が、色付きのブランチレーンと参照ピルで描かれます。ピルの色が凡例です。チェックアウト中のブランチ（HEAD）は青、リモートブランチは紫、タグは琥珀色、その他のローカルブランチは灰色です。ヘッダーのアイコンから、「現在の履歴項目へ移動」「すべてのリモートからフェッチ」「プル」「プッシュ」「更新」を実行できます。グラフは読み取り専用なので、コミットに対してできる操作は右クリック → 「コミットハッシュをコピー」だけです。

GitHub：公開、サインイン、プルリクエスト

GitHub に関する操作は、公開、クローン、サインイン、プルリクエストを含め、すべて公式の GitHub CLI（gh）を経由します。gh が見つからない場合は「GitHub CLI が必要です」というダイアログと「GitHub CLI を入手」ボタンが表示されます。Dock からアプリを起動した場合でも、Homebrew でインストールしたものを検出できます。

サインインには GitHub の Device Flow を使用します。「GitHub にサインイン」モーダルに短いコード（「コードをコピー」ボタン付き）が表示され、ブラウザが開いて承認を待ちます。ターミナルでの gh auth login に切り替えることもできます。アクセストークンは直接 gh に渡され、画面には表示されません。

リポジトリを GitHub へ公開すると、グラフの上に「プルリクエスト」領域が固定表示されます。オープン中の PR が #number とともに並び、オープンは緑、ドラフトは灰色のアイコンで示されます。領域のフッターには、サインイン中の @login が表示されます。+ ボタンを押すと、「タイトル」、「説明」、「作成」だけの最小限のダイアログが開き、現在のブランチから既定のブランチへの PR を作成できます。

PR にホバーすると、「PR をチェックアウト」（ローカルで gh pr checkout）または「ブラウザで開く」を選べます。クローンも同じパネルにあり、… →「リポジトリをクローン…」では owner/name または URL を入力します。この入口では保存先を尋ねません。クローンはホームフォルダへ置かれ、ファイルマネージャーで表示されます。現在のワークスペースはそのままです。

最後にもう1点あります。チャット入力欄の @ メニューには「メインとの差分」という項目があり、作業ツリーと main の差分をメッセージへ添付できます。まだコミットしていない作業をエージェントにレビューしてもらうときに便利です。次のレッスンでは、エージェントと共有するターミナルドックと、コードがナレッジグラフの一部になる仕組みを扱います。