compact-handoff

Reviewed at commit e670b00

EXPERIMENTAL: run /handoff or /handoffplan, then replace the conversation with the handoff and continue in the same terminal. Needs compact-handoff-answer…

Made by
REMvisual
What we checked

Adds /compact-handoff and /compact-handoffplan, which run your handoff skills, check the handoff file on disk, then replace the whole conversation with a short stub and send the skill's paste prompt so work continues. It shows a progress bar and room warnings, and refuses the model's own handoff attempts. Makes no network calls.

Review details

Static review of the source at the pinned commit; not run. Registers session.start (registers the commands compact-handoff, compact-handoffplan and a hidden internal compact-handoff-go), command.describe, command.run, tool.call for Write, Edit, Read and Skill, session.compact, prompt.submit, skill.prompt, ui.render for Spinner and AbovePrompt, and turn.complete. Runtime calls: $.command.run to start the handoff or handoffplan skills (which live outside this plugin and were not reviewed), $.prompt.submit (a fallback prompt, a request for missing detail when the handoff is under its line floor, and the final continue prompt taken from the skill output), $.session.usage and $.session.cwd, $.fs.read of the handoff and plan files named by the Write and Edit calls or the skill's READY line (files matching plans/handoffs or .claude/handoffs HANDOFF_ or PLAN_ *.md; the skill-reported path is also read after resolving it against the session folder), $.session.compact with instructions that start with the marker compact-handoff:v1 so the companion compact-handoff-answer plugin installs the stub, $.clock.after timers, $.ui.toast and plugin state atoms. The Write and Edit hooks observe only and always return the engine result. The Skill hook denies the model's own call to a handoff skill unless a run is active or the user asked for a handoff in words. It aborts without changing the conversation when the room, the files or the line floor check fails. Replacing the conversation is the stated purpose. No fetch, no processes, no file writes by the plugin itself. The unresolved ../types import is type-only (types/index.d.ts, included). Not reviewed: the handoff skills and the compact-handoff-answer companion (declared dependency, reviewed separately). npm dependencies: none.

What it uses
  • Reads your prompts: yes
  • Sees tool calls: yes
  • Blocks or changes tool calls: yes
  • Reads or writes files: yes
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes

EXPERIMENTAL: run /handoff or /handoffplan, then replace the conversation with the handoff and continue in the same terminal. Needs compact-handoff-answer. Tested on Claude Code 2.1.300.

Made this mod? Add a badge to your README

modsforClaude badge for compact-handoff

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/compact-handoff.svg)](https://modsforclaude.com/mods/compact-handoff/)

← All mods