mcpField
C
codex-session-manager

codex-session-manager

github.com/sugarforeverエージェントワークフロー139193 回インストール1 週間前に更新
リポジトリ

codex-session-manager について

codex-session-managerは、Codexのセッション記録を整理するためのスキルです。候補の一覧表示やJSONLのMarkdownへの出力に対応し、ツールの全ペイロードはリンク先の別ファイルに保存します。

主な機能

  1. 01セッションをMarkdownに出力
  2. 02候補セッションの一覧と選択
  3. 03アーカイブ済みセッションを含める
  4. 04プロジェクト、セッション、日付、件数で絞り込み
  5. 05ツールの全ペイロードをリンク先に分離

活用シーン

  1. 01Codexセッションの保管や検索
  2. 02選択した1件のセッションを出力
  3. 03アーカイブ済み記録を出力に含める
  4. 04全ペイロードを読み込まずにツール操作を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sugarforever/01coder-agent-skills --skill codex-session-manager

インストール後、Claude Code で/codex-session-managerを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamlscripts/manage_codex_sessions.py

詳細

Codex セッションマネージャー

概要

Codex はセッションのトランスクリプトを ~/.codex/sessions/YYYY/MM/DD/*.jsonl に JSONL ファイルとして保存します。アーカイブ済みのセッションが ~/.codex/archived_sessions/*.jsonl に存在する場合もあります。付属のマネージャーを使って候補を一覧表示するか、ダイジェスト、タイムライン、メッセージ本文、リンクされたツール呼び出しの詳細を含む Markdown のトランスクリプトにセッションをエクスポートできます。

デフォルトの出力フォルダー：~/.codex/session-markdown。ここにエクスポートする前にユーザーに伝え、ユーザーが指定したカスタム出力フォルダーがあれば、それについても伝えてください。

クイックスタート

ユーザーの依頼内容からモードが明確な場合は、そのモードを選択してください。不明な場合は、エクスポートの前にどちらのモードにするか確認してください。

  • フルモード：条件に一致するすべてのセッションをエクスポートします。アーカイブ、バックアップ、広範囲の検索、または「すべてのセッションを変換」という依頼に使用してください。
  • 個別モード：まず候補セッションを一覧表示し、ユーザーに選んでもらってから、そのセッションだけをエクスポートします。

任意のディレクトリから実行します。

python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py

便利なオプション：

  • --mode full：条件に一致するすべてのセッションをエクスポートします。デフォルトです。
  • --mode specific --list-candidates：番号付きの候補テーブルを表示し、エクスポートは行いません。
  • --mode specific --pick N：同じ絞り込み条件による候補リストから、N 番目の候補をエクスポートします。
  • --include-archived：~/.codex/archived_sessions もスキャンします。
  • --project <text>：日付／プロジェクトキーにこのテキストを含むものだけをエクスポートします。
  • --session <text>：ID またはファイル名にこのテキストを含むセッションだけをエクスポートします。
  • --since YYYY-MM-DD：この日付以降に変更されたセッションだけをエクスポートします。
  • --limit N：条件に一致したセッションのうち、変更日時が新しいものから N 件をエクスポートします。
  • --include-tool-details-inline：サイドカーファイルではなく、完全なツールのペイロードをメインのセッション Markdown に埋め込みます。

個別モードの候補選択フロー

Codex のセッションを 1 つだけ取得したい場合、必要なセッションがわからない場合、または変換前に最近のセッションを確認したい場合は、このフローを使用してください。

  1. 候補一覧のコマンドを実行します。ユーザーが別の件数を指定していない限り、デフォルトで --limit 20 を使用してください。
python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py \
  --mode specific \
  --list-candidates \
  --limit 20
  1. ユーザーから日付、セッション ID の一部、またはアーカイブに関するヒントが示された場合は、同じフィルターに渡します。
python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py \
  --mode specific \
  --list-candidates \
  --since 2026-06-01 \
  --include-archived \
  --limit 20
  1. 番号付きの候補行をユーザーに提示します。候補テーブルには、変更日時、日付／プロジェクトキー、短縮セッション ID、cwd、最初のユーザープロンプトの抜粋が含まれます。
  2. ユーザーが番号を選んだら、まったく同じフィルターを使って --pick N を指定し、再実行します。

ユーザーが正確なセッション ID または一意な断片をすでに指定している場合、曖昧さが少しでもあるときは、まず --mode specific --session <id-or-fragment> --list-candidates を使用してください。候補リストの一致が 1 件だけの場合に限り、--pick 1 でエクスポートします。

出力レイアウト

エクスポーターは次のものを書き出します。

~/.codex/session-markdown/
├── index.md
└── <date-or-archive-key>/
    ├── index.md
    ├── <session-id>.md
    └── tool-details/
        └── <session-id>.tools.md

各セッションの Markdown には、次の内容が含まれます。

  • ダイジェスト：ソースパス、キー、セッション ID、cwd、タイムスタンプ、イベント数／メッセージ数／ツール数、最初のユーザープロンプトの抜粋。
  • ツール呼び出しまたは結果が存在する場合、リンクされたツール詳細ファイル。
  • タイムライン：セッションのメタデータ、ユーザー／アシスタント／開発者のメッセージ、推論の要約、ツール呼び出し、ツール出力。
  • インラインには短いツールの要約を記載し、完全な JSON ペイロードはデフォルトでサイドカーファイルに保存します。

ワークフロー

  1. ソースフォルダーを確認します。デフォルトは ~/.codex/sessions です。アーカイブ済みセッションについてユーザーから依頼があった場合は、--include-archived を追加します。
  2. ユーザーがまだ選択していない場合は、フルモードと個別モードのどちらにするか確認します。
  3. 出力フォルダーを確認するか、ユーザーに伝えます。デフォルトは ~/.codex/session-markdown です。
  4. フルモードの場合、必要なフィルターを指定してマネージャースクリプトを実行します。
  5. 個別モードの場合、候補を一覧表示し、ユーザーに番号を選んでもらってから、--pick を指定してエクスポートします。
  6. エクスポートしたセッション数、出力インデックスのパス、解析に関する警告があれば報告します。

注意事項

  • トランスクリプトのデータはプライベートなものとして扱ってください。プロンプト、ファイルの内容、コマンド出力、チャットに誤って貼り付けられたシークレット、ツールの結果が含まれている場合があります。
  • 元の .jsonl ファイルを削除または変更しないでください。
  • 大規模なセッションでは、ツールの詳細をサイドカーファイルに保存する方法を優先してください。ツールのペイロードをインラインにすると、Markdown の検索や読み込みが難しくなる場合があります。

コメント

Markdown 対応