It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
Version
0.2.1
License
MIT
Repo stars
12
Last change
2026-10-03
What it can reach
Draws in the session
Reads usage or context figures
Calls another program on this machine
Needs Claude Code 2.1.287 or later with mods enabled. It answers compaction instead of Claude Code's summarizer. A fork of the session writes the handoff along a fixed outline. The fork reads the conversation from the prompt cache and has no tools. That call is on your own Claude plan or key, so this page does not list it as network access. If the fork fails, compaction goes back to Claude Code with the outline as its instructions. The handoff replaces the conversation and is also saved as Markdown. The default folder is ~/.claude/handoffs. The README does not say how to delete those files. The default trigger is core: Claude Code decides when, at its compact window. trigger self is off unless you set it. With self, the mod decides at a percent of the window, 70 by default. /compact classic compacts once the way Claude Code does without the mod. To switch the mod off, disable it in /plugin. precompute skip, the default, turns off Claude Code's background pre-compaction. Set precompute to core to leave it on. autoContinue never, the default, means the handoff follows as a prompt that asks only for an acknowledgement. An optional adapter executable is called with JSON on stdin. A missing adapter counts as no answer. In claude -p the hooks run, but nothing is drawn. The README does not name a drawing on the CLI or in the Desktop app. A checkout for one session is claude --plugin-dir with this folder.
The plugin is the repo root. The marketplace name is handoff-compact. With trigger set to self, source shows a toast that the compaction became a handoff and names the saved file. The default trigger is core, and the README does not name that toast. This page lists draws for that toast. compact-handoff, by REMvisual, writes a handoff, replaces the conversation, and toasts once context passes 70%. ctx-handoff, by cablate, hands a long session to a fresh conversation when the window fills. auto-handoff, by obie, writes a handoff file after idle and runs that handoff. This one replaces Claude Code's compaction summary with a handoff from a fork of the same session.
Demo
Screenshot of the author's GitHub page.
What it hooks into
session.compactWhen the context is compacted
session.measureWhen usage is measured
turn.completeWhen a turn ends
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's README and source, 4 files. They load when you open them.