handoff

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

3|2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/tysonthomas9/loomcli --skill handoff-tysonthomas9
Or copy as Structured Prompt for Agent
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.