export

エクスポート

目的

~/.codex/sessions または ~/.codex/archived_sessions から Codex セッションの JSONL ファイルをエクスポートし、読みやすい Markdown トランスクリプトに変換します。

実行要件

• Python 3.10 以降の python3 が必要です。

デフォルトのワークフロー

1. アクティブなワークスペースからエクスポーターを実行します。

if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --output-dir "$(pwd)/codex-session-exports"

2. JSON の結果を解析し、file、session_id、message_count、include_tools、selected_by を結果として扱います。
3. Markdown ファイルの絶対パスと、エクスポートの概要を簡潔に返信します。

選択ルール

• デフォルトでは、Codex がツールプロセスに公開している場合、CODEX_THREAD_ID または CODEX_SESSION_ID から現在の Codex 会話 ID を選択します。
• 現在の会話 ID が取得できない場合は、セッションメタデータの cwd が現在の作業ディレクトリと一致する Codex セッションのうち、最終更新日時が最も新しいものを選択します。
• セッション ID と cwd のどちらも一致しない場合は、全体から最終更新日時が最も新しい Codex セッションを選択します。
• ユーザーがセッション ID を指定した場合は、--session-id <id> を付けて実行します。
• ユーザーが JSONL パスを指定した場合は、--session-file <path> を付けて実行します。

コンテンツのルール

• デフォルトのエクスポートには、ユーザーに表示されるメッセージと、アシスタントに表示されるメッセージが含まれます。
• ユーザーが明示的に求めない限り、エクスポートしたトランスクリプト全体をチャットに貼り付けないでください。
• システムプロンプト、開発者向け指示、AGENTS コンテキスト注入、<skill>...</skill> などの Codex Skill コンテキスト注入、環境コンテキスト注入、暗号化された推論は公開しないでください。エクスポーターはこれらのレコードをスキップします。
• ツール呼び出しとコマンド出力はデフォルトでは除外されます。ユーザーがコマンドログまたは完全な実行トレースを求めた場合は、--include-tools を追加します。
• ローカルソースファイルのパスと cwd メタデータは、デフォルトでは Markdown 内でマスキングされます。ユーザーが完全なローカルソースパスを明示的に求めた場合にのみ、--show-paths を追加します。
• エクスポーターは、実質的な最終アクションとして実行します。エクスポートしたファイルのパスを報告する簡潔な返信は、後続のエクスポートでのみ表示されます。

便利なコマンド

最近のセッションを一覧表示します。

if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --list

特定のセッションをエクスポートします。

if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --session-id <session-id> --output-dir "$(pwd)/codex-session-exports"

ツールログを含めてエクスポートします。

if [ -n "${CODEX_EXPORT_SKILL_DIR:-}" ]; then
  EXPORT_SKILL_DIR="$CODEX_EXPORT_SKILL_DIR"
elif [ -f "$HOME/.codex/skills/export/scripts/export_codex_session.py" ]; then
  EXPORT_SKILL_DIR="$HOME/.codex/skills/export"
else
  EXPORT_SKILL_DIR="$HOME/.agents/skills/export"
fi
python3 "$EXPORT_SKILL_DIR/scripts/export_codex_session.py" --json --include-tools --output-dir "$(pwd)/codex-session-exports"

参考資料

• JSONL の選択ヒューリスティックとフォーマットの範囲については、references/selection-and-format.md を参照してください。