Codexセッションビューア

Codexのセッション保存先

Codex CLIはセッションごとに1つのJSONLファイルを作成し、日付別に保存します。各ターン、ツール呼び出し、Token数が記録され、ターミナルを閉じても削除されずローカルディスクに残ります。

~/.codex/sessions/YYYY/MM/DD/rollout-<timestamp>-<uuid>.jsonl

# 直前に実行したセッション：
ls -t ~/.codex/sessions/*/*/*/*.jsonl | head -1

# セッション内で話した内容を手掛かりに古い記録を探す：
grep -rl "the thing you remember" ~/.codex/sessions/ --include='*.jsonl'

ビューアがログから復元する内容

Codexのrolloutファイルには、session_meta、turn_context、response_item、event_msgなど複数のレコード形式が混在し、必要な情報も分散しています。ツール呼び出しと出力は別々のレコードに保存され、call_idで結び付けられます。完全な推論は暗号化され、要約フィールドが空の場合もあります。SessionViewerは、読み取れる情報を次のように組み直します。

• シェルコマンド（shell、exec_command）を、実際の出力と終了ステータス付きで表示。通常は折りたたまれ、必要なときだけ展開できます。
• パッチ（apply_patch）を、*** Begin Patchのテキスト塊ではなく、ファイルごとに色分けされたdiffとして表示します。
• 計画（update_plan）をチェックリストで表示し、Codexが何を進めようとして、どこまで完了したかを確認できます。
• 推論の要約はデフォルトで折りたたまれます。判断理由を知りたいときだけ展開できます。
• Web検索、生成画像、モデルの切り替え、コンテキスト圧縮、各ターンの所要時間も表示します。
• セッション全体のToken使用量を、最後のtoken_countレコードから取得します。

セッションをほかの人と共有する

多くのCodexログツールは、デスクトップアプリ、CLI、HTML出力スクリプトなど、ローカル利用が前提です。SessionViewerなら、共有リンクを作成を押すだけで、相手が何もインストールせずに開けるURLを発行できます。リンクは一覧表示もインデックス登録もされないランダムな文字列です。アップロード時には削除用コマンドも発行されるため、不要になったらいつでも削除できます。

Codex自身にセッションをアップロードさせる

自分でファイルを探す必要はありません。現在のセッションでCodexに依頼すると、セッションの保存先、サイズを減らす方法、アップロード手順をまとめたこのサイトの説明ファイルを読み、共有リンクを返してくれます。

このセッションを https://sessionviewer.cc にアップロードして、
閲覧用リンクを返してください。先に https://sessionviewer.cc/llms.txt を読んでください。