handoff

Hand off Claude sessions to a fresh instance while preserving context.

3|2|Updated Jan 24, 2026

Search Tags:#workflow #claude #beads #handoff #mail #context-preservation #session-cycle

Ready to run

npx skills add https://github.com/tysonthomas9/loomcli --skill handoff-tysonthomas9

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Handoff Claude sessions to a fresh instance while preserving work context to continue from the same hook.

Core Features & Use Cases

Handoff sessions to a fresh Claude instance to reset context while keeping the hooked work and beads state intact.
Use when context is reaching the token limit or you need a fresh perspective, allowing you to continue from your existing hook with minimal disruption.
Automatically primes the new session and resumes work from your hook using the SessionStart workflow and Beads state.

Quick Start

Run /handoff to hand off your current session to a fresh Claude instance.

Frequently Asked Questions about handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I preserve Claude session context when context limits are reached?▼

To preserve Claude session context when limits are reached, hand off the session to a fresh instance. This transfers your hooked work and beads state, allowing the new instance to continue from your existing hook with minimal disruption.

What is the best way to reset a Claude session while keeping my work state intact?▼

The best way to reset a Claude session while keeping work state intact is using a handoff mechanism. It automatically primes the new session via the SessionStart workflow, preserving your hooked molecule and beads state.

How do I hand off a Claude session to a fresh instance?▼

You hand off a Claude session by running the /handoff command. This initiates the handoff process, using gt mail send to notify and gt handoff to trigger the transfer to the fresh instance.

Does a Claude session handoff preserve Git state and beads?▼

Yes, a Claude session handoff preserves Git state and beads. The process specifically maintains the hooked molecule, beads state, and Git state across the transition to the fresh instance.

When should I use a session handoff instead of continuing in the current Claude instance?▼

Use a session handoff when context is reaching the token limit or when you need a fresh perspective. It allows you to continue work from your existing hook with minimal disruption to your workflow.