handoff

Transfer Claude session context to a fresh instance via beads and git.

5|Updated Oct 27, 2025
One-click install
npx skills add https://github.com/jbabin91/autocomplete-rs --skill handoff-jbabin91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/jbabin91/autocomplete-rs/tree/main/.claude/skills/handoff
Command: npx skills add https://github.com/jbabin91/autocomplete-rs --skill handoff-jbabin91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hand off your current Claude session to a fresh Claude instance to reset context while preserving work progress through beads and git.

Core Features & Use Cases

  • Beads-aware handoff: updates progress notes and preserves context across sessions.
  • Handoff orchestration: creates issues for remaining work, runs CI gates, commits and pushes, and generates a summary.
  • Use Case: when context nears token limit or need fresh perspective, you hand off to a new Claude session and resume.

Quick Start

Invoke the handoff command to transfer your session to a fresh Claude instance and preserve context.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I reset Claude session context when nearing the token limit?

To reset Claude session context near the token limit, use handoff to transfer control to a fresh Claude instance while preserving progress through beads and git commits. This orchestrates progress notes, issue creation, CI gates, and summary generation for seamless session resumption.

What is the best way to preserve context across multiple Claude sessions?

The best way to preserve context across Claude sessions is using beads-aware handoff, which updates progress notes and coordinates git commits, issue tracking, and summary generation. This ensures work progress is seamlessly maintained when transferring to a fresh Claude instance.

How do I hand off work to a fresh Claude instance without losing progress?

Hand off work to a fresh Claude instance by invoking handoff, which enforces a deterministic workflow that updates bead notes, files remaining work as issues, runs quality gates, commits and pushes changes, and presents a handoff summary for the new session to resume.

Does handoff work with git workflows and CI gates for session transitions?

Yes, handoff works with git workflows and CI gates by coordinating commits, pushing changes, running quality gates, closing completed issues, and generating a summary. It integrates git and beads to ensure deterministic session transitions with preserved context.

When should I use a session handoff instead of continuing my current Claude session?

Use a session handoff when your context nears the token limit or when you need a fresh perspective. It transfers control to a new Claude session while preserving work progress through beads, git commits, issue tracking, and summary generation.

Can I use handoff to create issues for remaining work before resetting context?

Yes, handoff creates issues for remaining work before resetting context. It enforces an explicit workflow that updates bead notes, files outstanding tasks as issues, runs CI gates, commits and pushes changes, and generates a handoff summary.