Are 'TodoWrite' items saved during a handoff?

No, TodoWrite items are session-scoped and ephemeral. You should commit or note important items in the handoff message before cycling the session.

When is the best time to use the /handoff command?

You should use it when your current context is approaching the token limit, when you've finished a major logical chunk of work, or if the AI seems to be struggling with a bloated conversation history.

What happens to my code changes during a handoff?

All Git state, including commits, branches, and staged changes, is fully preserved. Only the ephemeral conversation history is reset.

How does the new session know what I was doing?

The skill uses 'handoff mail' and pinned molecules within the Gas Town framework to ensure the fresh Claude instance inherits the previous session's progress and notes.

Session Handoff

Name: Session Handoff
Author: dbmcco

bydbmcco

Productivity & Workflow

Refreshes Claude sessions while preserving critical task context and development state.

About

The Session Handoff skill enables seamless transition between Claude instances, allowing users to bypass context window limitations without losing work progress. By leveraging the Gas Town agent framework, it preserves hooked work assignments, issue tracking (beads), and Git state while clearing the conversation history. This tool is essential for long-running development tasks, providing a way to 'cycle' the AI's memory to maintain high-quality outputs and a fresh perspective on complex codebases.

Key Features

Persistent work context and issue tracking preservation
Automated session re-priming via SessionStart hooks
Inter-session messaging via handoff mail system
0 GitHub stars
Seamless session cycling with token limit reset
Preservation of Git commits, branches, and staged changes

Use Cases

Refreshing the AI's perspective when stuck on a difficult debugging problem
Transitioning work between different logical phases of a development sprint
Managing complex coding projects that exceed Claude's token window

About

Key Features

Persistent work context and issue tracking preservation
Automated session re-priming via SessionStart hooks
Inter-session messaging via handoff mail system
0 GitHub stars
Seamless session cycling with token limit reset
Preservation of Git commits, branches, and staged changes

Use Cases

Refreshing the AI's perspective when stuck on a difficult debugging problem
Transitioning work between different logical phases of a development sprint
Managing complex coding projects that exceed Claude's token window