github REMvisual/claude-handoff v2.1.5
v2.1.5 — room check before Claude Code's auto-compact

latest release: v2.1.6
20 days ago

A Claude Code mod: handoff, compact, keep going

/compact-handoff runs the handoff skill, then replaces the conversation with the handoff and keeps working in the same terminal. No new window, no paste. It works like /compact, but what's left is your validated handoff instead of a lossy summary.

compact-handoff progress in the terminal

A live run at 20%: the spinner line and the bar above the prompt show the step the handoff is on.

claude plugin marketplace add REMvisual/claude-handoff
claude plugin install compact-handoff@claude-handoff
/compact-handoff [note]       # write the handoff, replace the conversation, continue from "Where We're Going"
/compact-handoffplan [note]   # same with a plan, then start Phase 1
/compact-handoff cancel       # drop a run that's stuck

What the mod does

  • Shows progress. Handoff N% · step in the spinner line and a bar above the prompt: Starting, Reading the session, Mining the session, Writing the handoff (lines against the minimum), Checking, Closing, Replacing the conversation, Done.
  • Checks the handoff before anything is replaced. The files must exist on disk, and the handoff must reach the minimum line count for the session's size (Chunked 500 lines from 500K tokens, Deep 300 from 100K). A short one gets one more turn to finish mining. If it's still short, nothing is replaced.
  • Tells the skill the measured context size, so it picks the right mining pass instead of guessing.
  • Keeps the model from starting a handoff on its own. Only you start one, with /compact-handoff, /handoff, or by asking.
  • New in 2.1.5: checks for room before it starts (below).

2.1.5

Fixed

  • A /compact-handoff started at 948K tokens on a 1M window looked like a 2-minute success but wrote nothing. Reading the skill's references took the context to 964K, and Claude Code's own auto-compact fired at 968,811 tokens before the handoff file existed. compact-handoff 0.1.5 reads Claude Code's auto-compact point and does not start when less room is left than a handoff needs (about 80K for a Chunked pass; two measured runs used 45K and 62K). It says so plainly instead.
  • If Claude Code compacts on its own during a run anyway, the mod ends the run, tells the summarizer the handoff was cut off, and shows "no handoff was written", so it never looks like a finished handoff.

Changed

  • The one-time 70% toast is replaced by warnings based on the room left before Claude Code compacts on its own: one at about 200K left ("a good point for /compact-handoff"), one at about 100K ("run it now"), and one when there is no longer room. Each shows once until the next compaction.

Update

claude plugin marketplace update claude-handoff
claude plugin update compact-handoff@claude-handoff

Restart Claude Code afterwards.

Full history: CHANGELOG.md

Don't miss a new claude-handoff release

NewReleases is sending notifications on new releases.