Claude Codeが読んだファイルをjqで一覧化

AnthropicのコーディングアシスタントであるClaude Codeは、会話ごとにjsonlログを残す。各行はJSONレコードで、そのtypeによって人のメッセージ、Claudeの返信、ツールが追加した添付、システム通知を区別する。この構造がスクリプトを可能にする。ツール呼び出しはassistantの返信内に、ツール結果はuserと型付けられた行に、添付は貼り付けたファイルや変更通知などを持つ。スクリプトはこれらの行を走査し、ClaudeがReadを呼ぶとファイルをreadと印し、Edit・MultiEdit・Write・NotebookEditではeditedと印し、compact_boundary行で会話が圧縮されたことが示されるとすべてをstaleに切り替える。

サンプルの実行は、出力を信頼する誰にとっても重要な2つの挙動を示す。圧縮前に読み込まれ以後触られていないファイルは、コンテキストに要約しか残らないためstaleのままだ。一方、圧縮前に編集され後に再読み込みされたファイルはreadに戻る。作者はisSidechainと印された行も除外する。サブエージェントの読み込みはメインのClaudeのコンテキストには届かないからだ。/rewindやEscキーでの巻き戻しはparentUuidの連鎖を分岐させ、スクリプトはすべての行を読むため、放棄されたブランチのファイルも表示される。

同じルールが、作者のmacOSアプリtanacodeのファイルツリー表示を支えている。これはClaude Codeの作業を監視するもので、fs.watchでログを漸進的に読み、後で読み込まれてもeditedマーカーを保持する。未解決の問いは、読者がこれをどこまで ground truth として扱うべきかだ。印はログに記録された内容を反映しており、作者は実行中のセッションでは最終行がまだ書き込み中かもしれず、ターンの途中で取ったスナップショットは最新の活動を逃す可能性があると注記している。