handoff
🎯Skillfrom steveyegge/beads
|handoff skill from steveyegge/beads
Installation
npx skills add https://github.com/steveyegge/beads --skill handoffSkill Details
>
Overview
# Handoff - Session Cycling for Gas Town Agents
Hand off your current session to a fresh Claude instance while preserving work context.
When to Use
- Context getting full (approaching token limit)
- Finished a logical chunk of work
- Need a fresh perspective on a problem
- Human requests session cycling
Usage
```
/handoff [optional message]
```
How It Works
- If you provide a message, it's sent as handoff mail to yourself
gt handoffrespawns your session with a fresh Claude- New session auto-primes via SessionStart hook
- Work continues from your hook (pinned molecule persists)
Examples
```bash
# Simple handoff (molecule persists, fresh context)
/handoff
# Handoff with context notes
/handoff "Found the bug in token refresh - check line 145 in auth.go first"
```
What Persists
- Hooked molecule: Your work assignment stays on your hook
- Beads state: All issues, dependencies, progress
- Git state: Commits, branches, staged changes
What Resets
- Conversation context: Fresh Claude instance
- TodoWrite items: Ephemeral, session-scoped
- In-memory state: Any uncommitted analysis
Implementation
When invoked, execute:
- If user provided a message, send handoff mail:
```bash
gt mail send
```
- Run the handoff command:
```bash
gt handoff
```
The new session will find your handoff mail and hooked work automatically.
More from this repository2
Tracks and manages distributed AI agent tasks using a git-backed graph issue tracking system with dependency awareness and semantic memory compaction.
Tracks and manages complex, hierarchical coding tasks for AI agents using a git-backed, dependency-aware graph system that provides persistent, structured memory across long-horizon projects.