## What — コメントを読む3つのコマンド Claude に「hunk のコメントを読んで直して」と頼んだとき、裏で使われるのはこれ。 ```bash hunk session list # 起動中セッションを探す hunk session review --repo . --json # 変更ファイル/hunk構造を把握（生diffは含めない） hunk session comment list --repo . --type user # 人間が c で残したコメントを読む ``` `--type` は `user`（人間） / `agent`・`ai`（AI） / `all` を切り替えられる。 **人間の指摘だけ拾いたいときは `--type user`**。 ## How — 返信と差分の差し替え 該当箇所を直したあと、返信コメントを残せる。 ```bash # 1件だけ返信 hunk session comment add --repo . --file src/App.tsx --new-line 42 \ --summary "指摘の通りXに修正しました" --author agent # 複数まとめて返信（stdin に JSON バッチ） printf '%s\n' '{"comments":[{"filePath":"src/App.tsx","newLine":42,"summary":"修正済み"}]}' \ | hunk session comment apply --repo . --stdin ``` `comment add` は「1件」、`comment apply` は「複数を一括」。 どちらも `--focus` を付けると、その TUI がコメント位置へジャンプする。 修正後の差分に更新したいときは、TUI を開き直さず `reload` で中身を差し替える。 ```bash hunk session reload --repo . -- diff # 最新の作業ツリー差分に更新 hunk session reload --repo . -- show HEAD~1 # 別コミットに切り替え ``` `--` の後ろに hunk のレビューコマンドを渡すのが作法（`--` を忘れるとエラー）。 > [!warning] つまずきどころ > - **`No active Hunk sessions`** … TUI が起動していない、または別プロセスがサンドボックスで `127.0.0.1` をブロックしている。まず TUI が開いているか確認する > - **`No visible diff file matches ...`** … そのファイルが今の TUI に読み込まれていない。`hunk session context` で現在の表示を確認し、必要なら `reload` > - **セッションが複数** … 同じリポジトリで複数 TUI を開くと曖昧になる。`<session-id>` を明示する > - **コメントが消えた** … TUI を閉じた。永続化されない仕様なので、往復中は開きっぱなしにする ## 関連 - [[開発環境]] - [[AIと働く]] - [[hunkでAIとローカルのコードレビューを往復する]] — 往復の全体像と3つの構成要素