handoff

Cycle Claude sessions while preserving work context and git state.

17.5k|1.6k|Updated Dec 16, 2025

Search Tags:#workflow #context management #Claude #handoff #mail #session cycling #Gas Town

One-click install

npx skills add https://github.com/steveyegge/gastown --skill handoff

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/steveyegge/gastown/tree/main/.claude/skills/handoff
Command: npx skills add https://github.com/steveyegge/gastown --skill handoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hand off your current Claude session to a fresh Claude instance while preserving work context. This avoids context bloat and keeps progress intact when you restart or re-energize your workflow.

Core Features & Use Cases

Session cycling: Spin up a new Claude session without losing the hooked molecule, beads, or git state.
Context preservation: Your current work stays on your hook and continues from where you left off.
Handoff messaging: Optionally send a mail to yourself with a note about what you swapped or discovered.
Automated priming: The new session auto-primes via the SessionStart hook for a seamless transition.

Quick Start

Use the /handoff command to cycle your current Claude session.

Simple handoff: /handoff
Handoff with notes: /handoff "Found the bug in token refresh - check line 145 in auth.go first"