codex-history

Codex の履歴

会話履歴を読み込んで、OpenAI Codex CLI で始めた作業を再開します。

データの保存場所

history.jsonl ファイルは 2 つあり、Codex のバージョンによっては、セッションファイルまたは SQLite の状態データもあります。

ソース	パス	内容
グローバルプロンプトインデックス	~/.codex/history.jsonl	session_id へのリンクを含むユーザープロンプト
プロジェクトごとのプロンプトインデックス	<project-root>/.codex/history.jsonl	同じ形式で、1 つのリポジトリに限定
セッションログ（旧形式）	~/.codex/sessions/YYYY/MM/DD/rollout-<timestamp>-<uuid>.jsonl	会話全体
SQLite の状態データ	~/.codex/state_5.sqlite	新しい形式のストレージ。スレッドデータが含まれる場合があります

新しいバージョンではセッションファイルが存在しないことがあるため、まず history.jsonl を参照し、セッション JSONL はより詳細な情報を取得できる任意のソースとして扱ってください。

ワークフロー

ステップ 0：キーワードで検索する

ユーザーがセッション ID ではなくトピックでチャットの内容を説明した場合は、グローバルとプロジェクトごとの両方の履歴ファイルから、プロンプトのテキストを検索します。

ステップ 1：セッション ID で検索する

セッションが別のリポジトリで始まっている可能性があるため、グローバルとプロジェクトごとの両方の履歴ファイルを確認します。

ステップ 2：最近のセッションを一覧表示する

ユーザーがどのセッションを選べばよいかわからない場合は、最近のプロンプトをタイムスタンプとセッション ID とともに表示します。

ステップ 3：セッション JSONL ファイルを探す

一致するセッションログがある場合は、より詳細な情報を取得するために使用します。存在しなくてもワークフローを中断しないでください。

ステップ 4：会話を抽出する

• セッション JSONL がある場合は、ユーザーとアシスタントのメッセージ、および関連するツール呼び出しを抽出します。
• ない場合は、同じ session_id を持つ history.jsonl のエントリーからタスクの流れを再構成します。

ステップ 5：作業を再開する

履歴を読んだ後：

1. Codex が何に取り組んでいたかを要約します。
2. 未完了の手順やターミナルエラーを確認します。
3. ユーザーが続けたい内容を確認します。
4. 最後の有用な状態から再開します。

ヒント

• セッションログは大きい場合があるため、生の JSONL を手作業で読むのではなく、必要な情報を抽出してください。
• cwd メタデータは、Codex が作業していたリポジトリを特定するのに役立ちます。
• ユーザーが具体的な内容を示さずに「codex の続きから」と言った場合は、最近のセッションを表示することから始めてください。