create-handoff

To save your Claude Code session state, run the handoff command to capture the current task, progress, decisions, modified files, next steps, and learnings into a timestamped file for seamless later resumption.

Preserving context during task switches requires saving your current progress and decisions to a handoff file. This captures modified files and next steps, enabling you to resume work later without losing contextual information.

Session handoff files are stored in the standard ~/.claude/handoffs/ directory. The files use a timestamped naming convention to prevent conflicts when multiple handoffs are saved during different sessions.

You should create a session handoff during end-of-session, breaks, or context-switch scenarios. Saving your progress at these points ensures you can seamlessly resume work without losing track of decisions and modified files.

Yes, you can resume a coding session after closing the terminal if you saved a handoff file beforehand. The handoff preserves your task, progress, and next steps, allowing you to pick up exactly where you left off.

No, creating a handoff requires no external dependencies or components. It independently saves your current session state directly to the local filesystem for later resumption.