Handoff to New Session

Spawn a continuation session in agent-deck with your current context inline.

When to Use

• End of work session when you want immediate continuation
• Handing off to a parallel agent
• Before context gets too full and you want a fresh session

Process

1. Gather context from the current conversation:

   • What task are you working on?
   • What's been completed?
   • What are the next steps?

2. Call the MCP tool:

   spawn_continuation_session({
     task: "Brief description of current work"
   })
   

3. Report to user:

   • Session name created
   • How to attach:

     agent-deck

     then select session, or run in background

Output

Tell the user:

• The session name (e.g.,

  auth-refactor-abc12

  )
• The handoff ID for reference
• How to attach: launch

  agent-deck

  TUI and select the session

Example

User: "I need to stop here, can you hand this off?"

You:

1. Summarize current task from conversation
2. Call

   spawn_continuation_session({ task: "Implementing OAuth login flow" })

3. Report: "Created session

   oauth-login-xyz89

   . Run

   agent-deck

   and select it to continue."

Notes

• The new session gets inline context - it can start working immediately
• If claude-mem is running, uses its summary (already synthesized by Haiku)
• Falls back to rolling checkpoint data if claude-mem unavailable
• Handoff is persisted for 7 days in case you need to reference it