codex-cli-session

Installation
SKILL.md

Codex CLI Session

Use this skill when the user wants Codex CLI to continue work through a pinned project session instead of starting a fresh session every time.

Use the project-root .codex-cli-session-id file as the primary source of truth for the session to resume.

The main user task must never run without an active session ID.

Do not use wrapper scripts. Run Codex CLI directly.

Workflow

  1. Read <project-root>/.codex-cli-session-id first.
  2. If the file exists and contains a valid session ID, use that value for the real Codex command.
  3. If the file is missing or empty, bootstrap a fresh Codex session with a short prompt that tells Codex to inspect the current directory and get ready to continue work in this project.
  4. After bootstrapping, recover the newest session ID from ~/.codex/session_index.jsonl and write it into .codex-cli-session-id.
  5. If bootstrap fails and .codex-cli-session-id still does not contain an active session ID, do not run the main user prompt. Report the failure and stop.
  6. Only after .codex-cli-session-id contains an active session ID, run the real user task with codex exec resume.
  7. Keep the user's prompt text exact unless they explicitly ask you to rewrite it.
Related skills
Installs
4
GitHub Stars
1
First Seen
Mar 19, 2026