| name | handoff |
| description | Summarize the current conversation into a handoff file saved to ~/.claude/handoffs/ |
Context
- Today's date: !
date +%Y-%m-%d
- Current time: !
date +%H%M
- Current project: !
basename $(pwd)
- Working dir: !
pwd
Your task
Review the entire conversation above and write a handoff file to:
~/.claude/handoffs/<project>_<date>_<time>.md
The handoff may be picked up by a different tool (Claude Code or Codex CLI), so keep it
self-contained — no tool-specific assumptions.
Use this structure:
# Session Handoff — <date> <time>
**Project:** <project>
**From:** Codex CLI
**Working dir:** <full path>
## What we were doing
<1–3 sentences on the main task or goal>
## Decisions made
<bullet list of key decisions or conclusions reached>
## Current state
<where things stand — what's done, what's in progress, what's broken>
## Gotchas / don't redo
<dead ends already tried, constraints to respect, traps to avoid — so the next agent
doesn't repeat work you already ruled out>
## Next steps
<actionable list — enough detail to resume without re-reading the conversation>
## Key files / commands
<important file paths, commands, or snippets referenced in the session>
After writing the file, tell the user the exact path.