What data is lost during a session handoff?

The conversational history, ephemeral TodoWrite items, and uncommitted in-memory analysis are reset to provide Claude with a fresh perspective.

How do I pass instructions to the next Claude session?

You can provide an optional message with the /handoff command, which is automatically sent as a handoff mail to the new session.

Will I lose my code changes when using handoff?

No. Your Git state, including all commits, branches, and staged changes, is fully preserved across sessions.

Does my progress in Gas Town persist?

Yes, all 'beads' state (issues, dependencies, progress) and your 'hooked molecule' remain active and available to the new session.

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

Use it when your context window is getting full, when you have finished a logical chunk of work, or if the model starts to lose focus.

Session Handoff & State Management

Name: Session Handoff & State Management
Author: steveyegge

bysteveyegge

•

2,077

Productivity & Workflow

Refreshes Claude sessions while preserving critical workspace context and project state for continuous development.

About

The Handoff skill enables Gas Town agents to cycle their current session into a fresh Claude instance, effectively clearing saturated conversation context without losing progress. It is particularly useful for managing long-running tasks that approach token limits or when a fresh perspective is required for complex debugging. By persisting hooked work assignments, issue tracking states, and Git changes, it ensures a seamless transition where the new session can immediately resume from the previous agent's stopping point.

Key Features

2,077 GitHub stars
Retention of Git state including commits and staged changes
Seamless integration with the Gas Town multi-agent workspace
Context window clearing via automated session respawning
Persistence of hooked work assignments and 'pinned molecules'
Automated handoff messaging via internal mail system

Use Cases

Managing long-running development tasks that exceed Claude's token limit
Transferring progress between agents within a multi-agent workflow
Resetting conversational history to improve reasoning on specific bugs

About

Key Features

2,077 GitHub stars
Retention of Git state including commits and staged changes
Seamless integration with the Gas Town multi-agent workspace
Context window clearing via automated session respawning
Persistence of hooked work assignments and 'pinned molecules'
Automated handoff messaging via internal mail system

Use Cases

Managing long-running development tasks that exceed Claude's token limit
Transferring progress between agents within a multi-agent workflow
Resetting conversational history to improve reasoning on specific bugs