session-recovery-codex

Parse local Codex session JSONL files to extract user requests and plan items.

425|37|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/cnfjlhj/ai-collab-playbook --skill session-recovery-codex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-recovery-codex
Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/main/skills/full/session-recovery-codex
Command: npx skills add https://github.com/cnfjlhj/ai-collab-playbook --skill session-recovery-codex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps developers restore and continue interrupted Codex conversations by locating local session records, extracting the last user request, open plan items, involved files, and key assistant outputs so work can resume with minimal context loss.

Core Features & Use Cases

  • Lists recent Codex sessions for the current project and summarizes topic, message counts, and last messages for quick selection.
  • Performs deep analysis of a specific session file to extract the last meaningful user request, open plan steps, changed files mentioned by tools, and key assistant excerpts.
  • Use case: a developer returns to a paused coding session and wants to quickly identify unfinished tasks and the files impacted before continuing the work.

Quick Start

List recent Codex sessions for this project and then recover the chosen session by its session id.

Frequently Asked Questions about session-recovery-codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I recover a paused Codex session and find unfinished tasks?

Recover a paused Codex session by running Python scripts that locate and parse local session JSONL files to extract the last user request, open plan items, changed files, and key assistant excerpts. This allows you to resume interrupted conversations with minimal context loss.

Can I list recent Codex sessions for a specific project before choosing one to resume?

Yes, you can list recent Codex sessions for a specific project. The script summarizes each session's topic, message counts, and last messages, allowing you to quickly select the correct session ID to resume your work.

What information is extracted from Codex session JSONL files during recovery?

Session recovery extracts the last meaningful user request, open plan steps, changed files mentioned by tools, and key assistant excerpts from local JSONL files. This provides the exact context needed to continue your developer workflow.

Do I need an internet connection or external network access to run Codex session recovery?

No, Codex session recovery operates entirely offline. The provided Python scripts parse local session metadata and response items without any external network communication, requiring only a Python runtime and access to your local sessions directory.

What do I need to run scripts that analyze Codex session files?

You need a Python runtime and access to your local Codex sessions directory to run the provided scripts. These scripts parse session metadata and response items from the JSONL files to restore your conversation context.

Why does session recovery focus on extracting open plan items and changed files?

Session recovery focuses on extracting open plan items and changed files because these elements identify unfinished tasks and impacted code areas. This targeted extraction from JSONL records ensures developers can resume paused coding work with accurate context.