Files

beads/crew/grip 8fa2729bbc feat: add /handoff skill for session cycling

Claude Code v2.0+ moved from .claude/commands/ to .claude/skills/.
This adds the handoff skill in the new format so workers can use
/handoff to cycle to fresh sessions.

The skill wraps `gt handoff` with optional message support.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-02 16:04:08 -08:00

1.7 KiB

Raw Blame History

name, description, allowed-tools, version, author

name	description	allowed-tools	version	author
handoff	Hand off to a fresh Claude session. Use when context is full, you've finished a logical chunk of work, or need a fresh perspective. Work continues from hook.	Bash(gt handoff:),Bash(gt mail send:)	1.0.0	Gas Town

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 handoff respawns your session with a fresh Claude
New session auto-primes via SessionStart hook
Work continues from your hook (pinned molecule persists)

Examples

# 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:

gt mail send <your-address> -s "HANDOFF: Session cycling" -m "<message>"

Run the handoff command:
```
gt handoff
```

The new session will find your handoff mail and hooked work automatically.

1.7 KiB Raw Blame History