hunk sessionコマンドの使い方とつまずき
What — コメントを読む3つのコマンド
Claude に「hunk のコメントを読んで直して」と頼んだとき、裏で使われるのはこれ。
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 — 返信と差分の差し替え
該当箇所を直したあと、返信コメントを残せる。
# 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 で中身を差し替える。
hunk session reload --repo . -- diff # 最新の作業ツリー差分に更新
hunk session reload --repo . -- show HEAD~1 # 別コミットに切り替え
-- の後ろに hunk のレビューコマンドを渡すのが作法（-- を忘れるとエラー）。
つまずきどころ
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つの構成要素
Table of contents