handoff

To create a portable handoff document, use the handoff tool to package your current session into a self-contained markdown file with sections for what happened, next steps, decisions, and environment details. This document can be pasted directly into a new agent session without needing file writes or saved state.

A session handoff document is a self-contained markdown file that captures your current session context, decisions, and next steps. You need one when transferring work between different agents, teammates, or devices, ensuring the new session can continue without requiring clarifying questions or prior environment details.

Yes, you can transfer context between Claude Code and other agents without writing files. The handoff tool generates a portable markdown document inline, printing the session context directly without persisting any artifacts or saving state, making it suitable for fresh sessions on different machines.

The best way to share session context across different machines is to generate a self-contained markdown handoff document. Because it requires no file writes or environment details, the portable document can be pasted into a new session or another agent, minimizing friction when transitioning work between devices.

Yes, the handoff document includes environment details and next steps. The generated markdown features dedicated sections for what happened, next steps, decisions, and environment, providing the receiving agent with all necessary context to continue the work without clarifying questions.

Agent transfers lose context without a handoff document because fresh sessions lack prior state and environment details. Generating a self-contained markdown handoff document packages the current session's decisions and next steps, ensuring the new agent can continue the work without needing clarifying questions.