mcpField
H
handoff

handoff

github.com/gastownhallAgent workflows28.3k215 installsUpdated 1d ago
Repository

About handoff

handoff is a skill for Gas Town agents that starts a fresh Claude session while retaining the assigned work and project state. It supports optional handoff notes and is intended for context limits, completed work chunks, or requests for a fresh perspective.

Key features

  1. 01Starts a fresh Claude session
  2. 02Optional handoff message
  3. 03Preserves assigned work
  4. 04Retains issue and Git state

Use cases

  1. 01Continue work near a context limit
  2. 02Cycle sessions after a work chunk
  3. 03Request a fresh perspective on a problem

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gastownhall/beads --skill handoff

After installing, type/handoffin Claude Code to confirm it loaded.

Details

From the project README

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

  1. If you provide a message, it's sent as handoff mail to yourself
  2. gt handoff respawns your session with a fresh Claude
  3. New session auto-primes via SessionStart hook
  4. 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:

  1. If user provided a message, send handoff mail:

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

  2. Run the handoff command:

    gt handoff

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

Comments

Markdown supported