handoff

Transfer session context to a new chat by running the handoff workflow to generate a portable handoff document. This document captures your current session state, ensuring you can seamlessly resume your conversation in a new chat without losing prior context.

A session handoff document is a self-contained file that captures your current session context for transfer. It works by writing this context to the OS temp directory, allowing the session state to survive repository changes and be easily referenced in a new chat.

Find the file path for your generated handoff document by checking the console output after running the handoff workflow. The system always prints the absolute path to the generated document so you can easily copy and paste it into your new chat session.

Focus the next session on a specific topic during a session transfer by providing an optional topic hint argument. The handoff document adapts to the user's topic, using this hint to guide the context and focus for the next chat session.

The handoff workflow works regardless of whether an active plan file exists. It captures the current session context independently, ensuring you can always generate a handoff document for transfer to a new chat without requiring a plan file.