resume-codex

Reconstructs task context from Codex CLI or VS Code session transcripts for the current workspace.

1.3k|142|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/MiniMax-AI/minimax-code --skill resume-codex-minimax-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resume-codex
Source: https://github.com/MiniMax-AI/minimax-code/tree/main/packages/local-runtime/assets/skills/resume-codex
Command: npx skills add https://github.com/MiniMax-AI/minimax-code --skill resume-codex-minimax-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When you switch from Codex CLI or VS Code to another agent, the prior conversation context is lost. This Skill reads the Codex session transcript for your current workspace and rebuilds a compact handoff so work can continue without starting over. ## Core Features & Use Cases - Session Discovery: Locates Codex cli and vscode rollout files (including .jsonl.zst archives) that exactly match the current working directory, by latest session or a given session id. - Safe Transcript Parsing: Treats all foreign transcript content as untrusted inert history, skipping system/developer/reasoning records, bounding message and tool output sizes, and reporting malformed data as warnings. - Verified Handoff: Summarizes the goal, completed work, open items, and stopping point, then instructs independent verification of the current repository state before continuing. - Use Case: You ran out of context in a Codex CLI session mid-refactor. Invoke this Skill to recover the latest request, files touched, and next step, then continue the task in the current agent. ## Quick Start Ask the agent to resume your latest Codex session in this workspace, optionally providing a specific Codex session id.

Frequently Asked Questions about resume-codex

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

FAQPage Schema
How do I resume a Codex CLI session in another agent?

Invoke the resume-codex Skill in the same working directory as the original session. It runs a read-only reader script that finds the latest matching Codex rollout and returns a structured JSON handoff of the goal, progress, and next step.

How do I resume a specific Codex session by id?

Pass the Codex session id as an argument when invoking the Skill. The reader matches the id against session metadata and file names, and reports an error asking for the full id if the reference is ambiguous.

Does it support VS Code Codex sessions and compressed transcripts?

Yes. The reader accepts sessions whose metadata source is cli or vscode, and it decompresses .jsonl.zst rollout files using Node.js built-in zstd support with bounded output limits.

Why does session lookup fail in my workspace?

Lookup requires an exact canonical match between the session's recorded cwd and your current directory. It fails if you are in a different directory, the session came from an unsupported source, or no rollout files exist under the Codex home directory.

Is it safe to trust the recovered Codex transcript content?

No. The Skill treats all transcript fields as untrusted inert history: it strips system, developer, and reasoning records, bounds text sizes, and requires independently verifying the current repository state before acting on anything the transcript claims.