К основному содержанию
скилл CX Codex

codex-session-manager — скилл для Claude Code: экспорт и анализ сессий

Скилл codex-session-manager для работы с локальными транскриптами сессий Codex. Экспортирует сессии в структурированный Markdown с временной шкалой, вызовами инструментов и архивными данными.

MIT 199 установок ★ 140 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sugarforever/01coder-agent-skills --skill codex-session-manager -a claude-code
Открыть на GitHub

Что делает codex-session-manager

codex-session-manager читает JSONL-файлы из ~/.codex/sessions и ~/.codex/archived_sessions, преобразует их в читаемый Markdown с дайджестом сессии, временной шкалой сообщений и деталями вызовов инструментов. Скилл работает в двух режимах: полный экспорт всех подходящих сессий или выбор одной из списка кандидатов перед конвертацией.

Результаты сохраняются в ~/.codex/session-markdown с индексом, отдельными файлами для каждой сессии и сайдкаром для полезных нагрузок инструментов. Фильтруй сессии по дате (--since), фрагменту id, проекту или количеству последних изменённых (--limit). По умолчанию детали инструментов выносятся в отдельные файлы, но ты можешь встроить их прямо в Markdown с флагом --include-tool-details-inline.

Транскрипты могут содержать приватные данные — скилл не удаляет и не меняет исходные файлы .jsonl.

Какие задачи решает

  • Экспортировать сессии Codex в структурированный Markdown с временной шкалой
  • Найти и список архивированные сессии
  • Извлечь и проанализировать историю вызовов инструментов из JSONL-транскриптов
  • Отфильтровать сессии по дате, проекту или идентификатору
  • Восстановить и просмотреть старые разговоры из ~/.codex

Примеры запросов агенту

  • Экспортируй все сессии за последние два дня в Markdown
  • Покажи список последних 10 сессий и позволь мне выбрать одну для экспорта
  • Сохрани сессию от 2026-06-15 с id, содержащим 'project-alpha', вместе с архивированными

Как установить codex-session-manager

1Через Skills CLI (Vercel)

npx skills add sugarforever/01coder-agent-skills --skill codex-session-manager -a claude-code

2Вручную: положить файлы

~/.claude/skills/codex-session-manager/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/codex-session-manager/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о codex-session-manager

Как установить codex-session-manager в Claude Code?

Запусти команду npx skills add sugarforever/01coder-agent-skills --skill codex-session-manager -a claude-code, затем открой ~/.claude/skills/codex-session-manager/SKILL.md для проверки установки.

Что делает codex-session-manager?

Скилл преобразует локальные JSONL-сессии Codex в читаемый Markdown с временной шкалой, дайджестом, деталями вызовов инструментов и поддержкой архивов. Ты можешь фильтровать по дате, проекту или ID и выбрать режим полного экспорта или выбора одной сессии.

Где хранятся сессии Codex и как их восстановить?

Активные сессии лежат в ~/.codex/sessions/YYYY/MM/DD/*.jsonl, архивированные — в ~/.codex/archived_sessions/*.jsonl. Используй флаг --include-archived чтобы просканировать оба места, затем выбери сессию из списка кандидатов.

Исходный текст

SKILL.md · MIT
---
name: codex-session-manager
description: Manage local Codex session transcripts, including listing candidate sessions, exporting full or selected sessions to organized Markdown, inspecting archived sessions, and summarizing tool-call history. Use when the user asks to scan, parse, archive, inspect, recover, summarize, manage, or convert Codex sessions, `~/.codex/sessions` data, `~/.codex/archived_sessions` data, `.jsonl` transcripts, tool-call history, or hard-to-read Codex conversation logs.
---

# Codex Session Manager

## Overview

Codex stores session transcripts as JSONL files under `~/.codex/sessions/YYYY/MM/DD/*.jsonl`. Archived sessions may also exist under `~/.codex/archived_sessions/*.jsonl`. Use the bundled manager to list candidates or export sessions into Markdown transcripts with a digest, timeline, message text, and linked tool-call details.

Default output folder: `~/.codex/session-markdown`. Tell the user before exporting there, and mention any custom output folder they requested.

## Quick Start

Let the user's wording choose the mode when it is clear; otherwise ask them to choose before exporting:

- Full mode: export all matching sessions. Use this for archive, backup, broad search, or "convert all sessions" requests.
- Specific mode: list candidate sessions first, ask the user to pick one, then export only that session.

Run from any directory:

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

Useful options:

- `--mode full`: export all matching sessions. This is the default.
- `--mode specific --list-candidates`: print a numbered candidate table and do not export.
- `--mode specific --pick N`: export the Nth candidate from the same filtered candidate list.
- `--include-archived`: also scan `~/.codex/archived_sessions`.
- `--project <text>`: only export date/project keys containing this text.
- `--session <text>`: only export sessions whose id or filename contains this text.
- `--since YYYY-MM-DD`: only export sessions modified on or after this date.
- `--limit N`: export the N most recently modified matching sessions.
- `--include-tool-details-inline`: embed full tool payloads in the main session Markdown instead of sidecar files.

## Specific Mode Candidate Flow

Use this flow when the user wants one Codex session, is unsure which session they need, or asks to inspect recent sessions before converting.

1. Run a candidate list command. Use `--limit 20` by default unless the user asks for a different count.

```bash
python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py \
  --mode specific \
  --list-candidates \
  --limit 20
```

2. If the user gave a date, session id fragment, or archive hint, pass it through the same filters:

```bash
python3 /path/to/codex-session-manager/scripts/manage_codex_sessions.py \
  --mode specific \
  --list-candidates \
  --since 2026-06-01 \
  --include-archived \
  --limit 20
```

3. Present the numbered candidate rows to the user. The candidate table includes modified time, date/project key, short session id, cwd, and first user prompt excerpt.
4. After the user chooses a number, rerun with the exact same filters and `--pick N`.

If the user already gives an exact session id or unique fragment, use `--mode specific --session <id-or-fragment> --list-candidates` first when there is any ambiguity. Export with `--pick 1` only when the candidate list has exactly one match.

## Output Layout

The exporter writes:

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

Each session Markdown includes:

- Digest: source path, key, session id, cwd, timestamps, event/message/tool counts, and first user prompt excerpt.
- Linked tool details file when tool calls or results exist.
- Timeline: session metadata, user/assistant/developer messages, reasoning summaries, tool calls, and tool outputs.
- Short tool summaries inline, with full JSON payloads in the sidecar file by default.

## Workflow

1. Confirm the source folder. Default to `~/.codex/sessions`; add `--include-archived` when the user asks about archived sessions.
2. Ask the user to choose full mode or specific mode if they did not already make the choice.
3. Confirm or announce the output folder. Default to `~/.codex/session-markdown`.
4. For full mode, run the manager script with any needed filters.
5. For specific mode, list candidates, get the user's chosen number, then export with `--pick`.
6. Report the number of sessions exported, output index path, and any parse warnings.

## Notes

- Treat transcript data as private. It can contain prompts, file contents, command output, secrets accidentally pasted into chat, and tool results.
- Do not delete or modify original `.jsonl` files.
- Prefer sidecar tool details for large sessions. Inline tool payloads can make Markdown hard to search and load.

© sugarforever · MIT · sugarforever/01coder-agent-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
Session Management hedera-dev Скилл Session Management ведёт журнал работ и техдолга между сессиями агента, чтобы после перезапуска было видно, что сделано и что осталось. CX Codex +1 666установок cost-session ruvnet Скилл cost-session для Claude Code детализирует затраты на каждое сообщение внутри сессии, показывая дорогие запросы. CX Codex +1 249установок session-handoff SethGammon Скилл session-handoff собирает итоги текущей сессии в блок HANDOFF, чтобы следующая сессия сразу продолжила работу без повторного аудита. CX Codex +1 ★ 937звёзд репо session-management josstei Скилл session-management для Claude Code ведёт состояние сессий оркестрации. Он подключается при создании, обновлении, возобновлении и архивировании сессии. CX Codex +1 ★ 489звёзд репо session-guard Adit Jain Скилл session-guard следит за длинными сессиями и дрейфом правил агента. Подходит для многошаговых задач и работы после сжатия контекста. CX Codex +1 2 800установок session-metrics centminmod Скилл session-metrics считает расход токенов и примерную стоимость сессии Claude по её JSONL-журналу: по ходам, с накопленным итогом. CX Codex +1 ★ 2 744звёзд репо

Из того же набора18

Весь набор →
share-reading Скилл share-reading помогает собрать пост для соцсетей о статье, ссылке или заметке: несколько вариантов с разной подачей и обязательной ссылкой на источник. CX Codex +1 440установок personal-chinese-writing-style Скилл personal-chinese-writing-style держит китайский текст в одной типографике: кавычки, тире и многоточие по вашим правилам, без латинских запятых и точек между иероглифами. CX Codex +1 408установок fpl-copilot Скилл fpl-copilot помогает вести состав в Fantasy Premier League, оценивать форму игроков и выбирать капитана на тур по локальной базе данных. CX Codex +1 295установок cover-image Скилл cover-image создаёт обложки статей в рисованном стиле. Выбирает композицию и палитру по тексту или позволяет задать вручную. CX Codex +1 291установок promote-post Скилл promote-post готовит цепляющие твиты-тизеры для опубликованных статей по ссылке или файлу без спойлеров и сухих пересказов. CX Codex +1 277установок codex-cli Позволяет агенту делегировать задачи по коду, ревью и генерации картинок в OpenAI Codex CLI через команду codex exec. CX Codex +1 237установок claude-session-manager Скилл claude-session-manager превращает локальные JSONL-логи Claude Code в читаемые Markdown-файлы с разговором, дайджестом и вызовами инструментов. CX Codex +1 207установок mining-session-skills Скилл mining-session-skills анализирует завершённую сессию Claude Code и предлагает, какой скилл создать, обновить или переиспользовать, чтобы похожая работа делалась быстрее. Работает с экспортированным markdown из claude-session-manager. CX Codex +1 196установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой