CodexGo — Session Recovery

What it does

CodexGo restores the last actionable Codex request for the current workspace when a session is interrupted by compaction, a crash, or other context loss. It reads the saved session snapshot and surfaces a concise recovery summary: the resolved request to continue, the literal last user message, supporting context, and ambiguity hints. This lets the agent or user decide to resume, re-run, or request clarification without guessing.

When to use it

Use CodexGo at the start of a fresh session when the user explicitly asks to recover the prior Codex context (for example by running codexgo or asking to "recover the last Codex session"). Do NOT auto-trigger during an active conversation from vague prompts like "continue" — it is designed for explicit recovery scenarios.

What's included

• Scripts: scripts/codexgo.py — command-line runner that emits a JSON summary of the recovered request.
• References: Inline fields documented in the SKILL.md describing resolved_request, literal_last_user_message, last_conversation_content, and other recovery metadata.

Instructions (summary)

Run the provided script (python scripts/codexgo.py --cwd "$PWD" --format json) to produce a structured JSON describing what to resume and why. Review the needs_more_context and ambiguity_hints fields before executing or continuing. If the user requests execution, briefly restate the recovered request and proceed.

Compatible agents

CLI-friendly assistants and code-focused agents that run Python scripts and handle structured JSON outputs (Codex-style assistants, Copilot-like agents, or CLI-based agent runners).