Claude To Codex History

Claude Code の JSONL セッションを Codex が使用できるアーティファクトに変換します。オプションでインストール済みの Codex 再開エントリを含みます。

デフォルトワークフロー

1. ユーザーが codex resume を希望する場合、同一ディレクトリ再開ワークフローを使用します。
2. ユーザーがポータブルなアーティファクトのみを希望する場合、--include-predecessors -o <handoff.md> で Markdown をエクスポートします。
3. ユーザーが機械可読の生データを要求する場合、messages-jsonl をエクスポートします。
4. スタンドアロンの codex-jsonl は明示的に要求された場合のみエクスポートします。Codex にインストールされない限り、アーカイブ用です。

ターゲット人間ワークフロー

このエンドツーエンドフローをサポートします：

1. ユーザーはプロジェクトディレクトリ内の Claude Code で作業します。
2. ユーザーが Claude Code を終了し、Claude セッション ID または名前変更されたセッションタイトルのいずれかを保持します。
3. ユーザーが同じプロジェクトディレクトリから Codex を開始します。
4. ユーザーが Claude セッション名または ID でこのスキルを使用するよう Codex に要求します。
5. Codex が Claude セッションを変換し、合成 Codex 再開セッションをインストールします。
6. Codex が正確な codex resume <session-id> コマンド、スレッド名、および完全なハンドオフパスをレポートします。
7. ユーザーが現在の Codex チャットを終了します。
8. ユーザーが codex resume を実行するか、インポートされたスレッドを選択するか、正確なコマンドを実行します。

同一ディレクトリ再開ワークフロー

ユーザーがディレクトリ内で Claude Code を終了し、同じディレクトリで Codex を開始し、後で codex resume を使用できるように Claude セッション名または ID を変換したい場合に使用します。

常にプロジェクトディレクトリから実行します。まず候補をプレビューします：

SESSION_NAME_OR_ID="put-session-name-or-id-here"
python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" --same-directory --list

一致が明確な場合、ドライラン でインストールをシミュレートします：

SESSION_NAME_OR_ID="put-session-name-or-id-here"
SHORT_NAME="put-short-readable-name-here"
python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" \
  --same-directory \
  --include-predecessors \
  --tool-output-chars 4000 \
  --install-codex-session \
  --thread-name "Imported Claude: $SHORT_NAME" \
  --dry-run

その後、再開可能な Codex セッションをインストールします：

SESSION_NAME_OR_ID="put-session-name-or-id-here"
SHORT_NAME="put-short-readable-name-here"
python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" \
  --same-directory \
  --include-predecessors \
  --tool-output-chars 4000 \
  --install-codex-session \
  --thread-name "Imported Claude: $SHORT_NAME"

印刷されたコマンドをユーザーにレポートします：

codex resume <printed-session-id>

また、スレッド名と full_handoff_path もレポートして、ユーザーが再開ピッカーでインポートされたセッションを見つけたり、必要に応じて古い Claude 履歴を検査したりできるようにします。

その後、ユーザーは現在の Codex チャットを終了し、codex resume を実行するか、インポートされたスレッドを見つけるか、正確な codex resume <id> コマンドを実行できます。

インストール時の動作

--install-codex-session は、最初のユーザーメッセージとして制限された継続コンテキストを含む合成 Codex セッションを書き込みます。また、完全な Markdown ハンドオフを ~/.codex/claude_imports/ に書き込み、~/.codex/session_index.jsonl に行を追加し、そのインデックスのタイムスタンプ付きバックアップを最初に作成します。Codex SQLite の状態は変更しません。

これは意図的に高い互換性を持つミミック です：Codex は、数千の偽ツールイベントではなく、コンパクトなインポートされたコンテキストを含む通常のインタラクティブスタイルのセッションを見ます。制限されたコンテキストが重要なのは、複数日にわたる Claude トランスクリプトが Codex のモデルコンテキストウィンドウを超え、再開時に失敗する可能性があるためです。

その他のコマンド

一致する Claude セッションをリストアップします：

python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" --list

名前変更されたセッションから完全なハンドオフを作成します。コンパクト概要トランスクリプト参照に従います：

python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" --include-predecessors -o /tmp/claude-handoff.md

正規化された機械可読メッセージを作成します：

python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" --include-predecessors --format messages-jsonl -o /tmp/claude.messages.jsonl

ベストエフォート型の Codex ロールアウト JSONL を作成します：

python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" --include-predecessors --format codex-jsonl -o /tmp/claude.codex.jsonl

ベストエフォート型のネイティブ Codex 再開エントリをインストールします：

python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" --same-directory --include-predecessors --install-codex-session --thread-name "Imported Claude: $SHORT_NAME"
codex resume <printed-session-id>

ネイティブインストールを書き込みなしでプレビューします：

python3 scripts/claude_to_codex_history.py "$SESSION_NAME_OR_ID" --same-directory --include-predecessors --install-codex-session --dry-run

スタブル ハンドオフを使用して Codex で継続します：

codex -C /path/to/workspace "$(cat /tmp/claude-handoff.md)"

フォーマット選択

• デフォルトでは markdown を使用します。これは安定性が高く、読みやすく、Codex プロンプトまたはメモリとして機能します。
• ダウンストリームスクリプトまたは監査には messages-jsonl を使用します。
• codex-jsonl はベストエフォート型のアーカイブのみに使用します。Codex の内部ロールアウトスキーマは変更される可能性があるため、このファイルだけから codex resume の互換性を保証しないでください。
• ユーザーが明示的に codex resume 統合を希望する場合のみ --install-codex-session を使用します。これにより、コンパクトな継続コンテキストを含む合成 Codex 形式のセッションを書き込み、完全なハンドオフをサイドカー Markdown ファイルとして書き込み、~/.codex/session_index.jsonl に行を追加し、インデックスを最初にバックアップします。
• 小さいセッションまたは明示的なデバッグの場合のみ --install-full-context を使用します。大規模な完全履歴インストールは、再開時に Codex コンテキストウィンドウエラーで失敗する可能性があります。

セーフティルール

• ユーザーが明示的にネイティブセッションのインストールを要求しない限り、~/.codex/sessions、~/.codex/session_index.jsonl、または Codex SQLite の状態に書き込まないでください。
• --install-codex-session を使用する場合、まず --dry-run を実行し、計画されたパスを確認します。Codex SQLite の状態は決して変更しないでください。
• 再開インポートをテストする場合、codex exec resume <session-id> "<small verification prompt>" を使用し、インストールされたコンパクトコンテキストから回答できるかチェックします。
• 生の Claude ソースパスを生成されたハンドオフに保持して、別のエージェントが必要に応じて元のトランスクリプトを再度開くことができるようにします。
• ハンドオフをユーザーのマシンの外で共有する前に --redact-secrets を使用します。
• ユーザーが本当に完全なツール出力を希望する場合のみ --full-tools または --entire を使用します。それ以外の場合、大規模なログは可読性のため切り詰められます。

スクリプト注釈

コンバーターは、Claude JSONL パス、プロジェクトディレクトリ、セッション UUID、または検索文字列を受け入れます。検索文字列は、まず ~/.claude/history.jsonl に対してマッチングされ、次にプロジェクト JSONL の内容に対してマッチングされます。

--entire は --include-predecessors --full-tools の短縮形です。Claude コンパクト概要に埋め込まれたトランスクリプトパスを再帰的にたどります。