Codex Session Handoff for Local Continuation Snapshots

Save a local snapshot of the current goal, completed work, verification evidence, and next actions so a new Codex session can resume a long task.

中文

Install in Codex

Codex, Python 3, the current working copy, and a writable local handoff directory.

Copy the pinned `skills/session-handoff/` folder into `.agents/skills/session-handoff/` in the project. Keep its script and templates together.
Open Codex and select `$session-handoff`. For a project install, resolve `scripts/create_handoff.py` from that skill directory.

Example task

In a fictional CSV-export project, record a header change, an older format still awaiting verification, and two test results. Ask for a handoff folder and the prompt a new session should read.

What to check

The new session gets a local folder and startup prompt that make completed, unverified, and next work easy to identify.

Original SKILL.md on GitHub · Updated 2026-11-13

Frequently asked question

Where does it write the snapshot?

The default is `.handoffs` in the user home directory. Set `SESSION_HANDOFF_HOME` to choose another local directory.