Hyla を使う

変更

セッションが git リポジトリで作業していると、Hyla はそのブランチと変更内容を表示し、エージェントの作業をペインの横でレビューできます。

ブランチをひと目で

各ペインのタイトルには、作業中のブランチと、最後のコミットから追加・削除された行数が表示されます: fix-login +40 −2。進行中のマージやリベースもそこに表示されます。

サイドバーでは、リポジトリのデフォルト以外のブランチにいるセッション(専用のワークツリーで作業するエージェントなど)に、そのブランチ名が表示されます。セッションにポインタを合わせると、ブランチ、アップストリームとの差(先行・遅れ)、変更されたファイル数がわかります。

変更パネル

ペインのブランチをクリックするか、⌥ ⌘ G を押すと、セッションの右に変更パネルが開きます。次のいずれかの時点から変更されたファイルが、それぞれの追加・削除行数とともに一覧されます:

  • 直前のターン: セッションのエージェントが最後に作業を始めた時点。最新のターンで何をしたかだけがわかり、それ以前の変更は含まれません。Hyla はエージェントが作業を始めるときにワークツリーのスナップショットを取ります。インデックスやファイルには触れません。
  • 未コミット: 最後のコミット。未追跡のファイルも含みます。
  • ブランチ: ブランチがリポジトリのデフォルトブランチから分かれた時点。プルリクエストと同じ見え方です。

各ファイルのすぐ下に差分が順に表示され、エージェントが編集を続けると差分も追従します。長い差分をスクロールしている間も、ファイル名は上部に残ります。ファイル名をクリックすると差分を折りたたんだり展開したりできます: バイナリファイルと変更行がとても多いファイルは、最初から折りたたまれています。パネルの端をドラッグすると幅を変えられます。

パネルが狭い間は差分が統合表示され、広くなると左右に並べて表示されます。一覧の概要の右にあるボタンで 2 つを切り替えられ、その選択は diff-layout 設定に保存されます。

ターンをレビューする

直前のターンでは、変更にポインタを合わせると 2 つのボタンが現れます:

  • 元に戻す は、ファイルに古い行を戻します。
  • 保持 は、変更を確認済みにして隠します。

元に戻すは、セッションでエージェントが作業していない間だけ、そして差分の表示どおりのままのファイルにだけ使えます。エージェントの編集と競合しないためです。その間に変更されたファイルは、新しい差分として表示し直されます。

専用のワークツリーで動くセッション

1 つのチェックアウトで並んで作業するエージェントは、互いの変更につまずきます。セッション › ワークツリーで新規セッション…(⌘ ⌥ T)はブランチ名を尋ね、専用の git ワークツリーでセッションを開始します: リポジトリのデフォルトブランチから作った新しいブランチをチェックアウトするフォルダです。

  • ワークツリーはリポジトリ内の .hyla/worktrees/<branch> に置かれます。Hyla はそれを .gitignore ではなく .git/info/exclude で無視します。ほかの場所に置くには worktree-dir を設定します。
  • デフォルトブランチではなく、今いるセッションから分岐するには worktree-base = current を設定します。
  • セッションはリポジトリのプロジェクトに入り、サイドバーにはそのブランチが表示されます。

セッションを閉じると、ワークツリーも削除するか尋ねます:

  • 未コミットの変更がない: 既定は「ワークツリーを削除」です。ブランチはマージ済みなら一緒に削除され、そうでなければコミットとともに残ります。
  • 未コミットの変更がある: Hyla は失われるファイルの数を示し、既定は「ワークツリーを残す」です。
  • ほかのセッションがそのワークツリーで作業している: ワークツリーは残り、Hyla は尋ねません。

コマンドラインから:

sh
hyla new --worktree fix-login -- claude   # 専用のワークツリーで、新しいブランチのセッション
hyla new --worktree fix-login --base dev  # dev から分岐する
hyla close fix-login --remove-worktree    # 閉じて、ワークツリーを削除する
hyla close fix-login --remove-worktree --force   # 未コミットの変更があっても

コマンドラインから

hyla diff は、ペインの変更を git diff と同じ形式で、未追跡のファイルも含めて出力します:

sh
hyla diff                       # このペインの未コミットの変更
hyla diff --turn                # エージェントが直前のターンで変更したもの
hyla diff review --branch       # review セッションのデフォルトブランチ以降の変更
hyla diff src/auth              # これらのパスだけ

hyla status --json と hyla ls --json には、各ペインのブランチと変更が git として含まれます。

オフにする

git-status = false を設定するか、設定で git の状態を表示 をオフにすると、Hyla はリポジトリで git を実行しなくなります。